2.4 Файлы заголовков, включаемые только один раз ¶

Если файл заголовка включается дважды, компилятор обработает его содержимое дважды. Это очень вероятно приведёт к ошибке, например, если компилятор увидит дважды одно и то же определение структуры. Даже если этого не произойдёт, это обязательно займёт время.

Стандартный способ предотвращения этого — заключить всё реальное содержимое файла в условный оператор, как это показано ниже:

/* File foo.  */
#ifndef FILE_FOO_SEEN
#define FILE_FOO_SEEN

the entire file

#endif /* !FILE_FOO_SEEN */

Эта конструкция обычно известна как обёртка #ifndef. Когда заголовок включается снова, условие будет ложным, потому что FILE_FOO_SEEN определено. Препроцессор пропустит всё содержимое файла, и компилятор не увидит его дважды.

CPP оптимизирует ещё сильнее. Он запоминает, когда файл заголовка имеет обёртку «#ifndef». Если последующее включение «#include» указывает на этот заголовок, и макрос в «#ifndef» всё ещё определён, он вообще не будет пересканировать файл.

Вы можете размещать комментарии вне обёртки. Они не повлияют на эту оптимизацию.

Макрос FILE_FOO_SEEN называется контролирующим макросом или макросом-защитой. В файлах заголовков пользователя имя макроса не должно начинаться с «_». В системных файлах заголовков оно должно начинаться с «__», чтобы избежать конфликтов с пользовательскими программами. В любом виде файла заголовка имя макроса должно содержать имя файла и некоторую дополнительную информацию, чтобы избежать конфликтов с другими файлами заголовков.