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 называется управляющим макросом или макросом-стражем. В пользовательском файле заголовка имя макроса не должно начинаться с ‘_’. В системном файле заголовка оно должно начинаться с ‘__’, чтобы избежать конфликтов с пользовательскими программами. В любом типе файла заголовка имя макроса должно содержать имя файла и некоторый дополнительный текст, чтобы избежать конфликтов с другими файлами заголовков.