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

Далее: Альтернативы обёртке #ifndef, Предыдущее: Путь поиска, Вверх: Заголовочные файлы [Содержание][Индекс]