Зачем нужны #ifndef и #define в заголовочных файлах C++?

Что такое include guard и зачем он нужен?

Конструкция #ifndef, #define, #endif в заголовочных файлах называется include guard (страж включения). Её задача — предотвратить многократное включение одного и того же заголовочного файла в процессе компиляции. На первый взгляд кажется, что вы подключаете файл один раз, но на практике ситуация сложнее.

Как возникает двойное включение?

Представьте, что у вас есть два заголовочных файла: math_utils.h и string_utils.h. Оба они, в свою очередь, подключают общий файл defines.h (например, с макросами или типами). Теперь в main.cpp вы пишете:

#include "math_utils.h"
#include "string_utils.h"
#include "defines.h" // ещё одно прямое включение

Без include guard файл defines.h будет включён трижды! Препроцессор просто вставляет текст файла каждый раз, когда встречает #include. В результате компилятор увидит повторяющиеся объявления классов, функций или переменных, что вызовет ошибку "redefinition" (переопределение).

Как работает include guard?

Механизм простой и элегантный:

• #ifndef SOME_UNIQUE_NAME — проверяет, не определён ли уже макрос SOME_UNIQUE_NAME.
• Если макрос не определён (первое включение), препроцессор идёт дальше, выполняет #define SOME_UNIQUE_NAME (определяет макрос) и включает весь код до #endif.
• Если макрос уже определён (повторное включение), препроцессор пропускает всё до #endif — файл не вставляется повторно.

Пример правильного заголовочного файла:

// defines.h
#ifndef DEFINES_H
#define DEFINES_H

const int MAX_SIZE = 100;
struct Point { int x, y; };

#endif // DEFINES_H

Почему ошибка не проявляется в вашем примере?

В вашем простом проекте functions.h включается только один раз — в main.cpp и один раз — в functions.cpp. Но это разные единицы трансляции (разные .cpp файлы компилируются отдельно). Include guard защищает от повторного включения в рамках одной единицы трансляции.

Ошибка проявится, когда вы начнёте создавать более сложные иерархии заголовков. Например:

// shapes.h
#include "point.h"
class Circle { /* ... */ };

// circles.h
#include "shapes.h" // уже включил point.h
#include "point.h"  // явное включение — без guard будет ошибка!
class ColoredCircle : public Circle { /* ... */ };

Современная альтернатива: #pragma once

Многие современные компиляторы (GCC, Clang, MSVC) поддерживают директиву #pragma once. Она делает то же самое, но короче:

// defines.h
#pragma once

const int MAX_SIZE = 100;
struct Point { int x, y; };

Однако #ifndef/#define — это стандартный и переносимый способ, гарантированно работающий на всех компиляторах. #pragma once не является частью стандарта C++, хотя и поддерживается везде на практике.

Рекомендации

• Всегда используйте include guard в заголовочных файлах — это хорошая привычка.
• В качестве имени макроса используйте имя файла заглавными буквами, заменяя точку на подчёркивание (например, FUNCTIONS_H).
• Если ваш проект использует только современные компиляторы, можно применять #pragma once — это сокращает код и снижает риск опечаток.