2.8 Файлы заголовков системы ¶

Файлы заголовков, объявляющие интерфейсы операционной системы и библиотек выполнения, часто не могут быть написаны в строго соответствии со стандартом C. Поэтому GCC предоставляет специальное обращение к коду, найденному в файлах заголовков системы. Все предупреждения, кроме тех, которые сгенерированы ‘#warning’ (см. Диагностика), подавляются во время обработки GCC файла заголовка системы. Макросы, определённые в файле заголовка системы, защищены от нескольких предупреждений, где бы они ни были расширены. Эта защита предоставляется по мере необходимости, когда мы обнаруживаем, что предупреждение генерирует много ложных срабатываний из-за кода в макросах, определённых в файлах заголовков системы.

Обычно только заголовки, найденные в определённых директориях, считаются файлами заголовков системы. Эти директории определяются при компиляции GCC. Однако есть два способа превратить обычные заголовки в заголовки системы:

• Файлы заголовков, найденные в директориях, добавленных в путь поиска с помощью командной строки -isystem и -idirafter, обрабатываются как файлы заголовков системы для целей диагностики.
• Также существует директива, #pragma GCC system_header, которая сообщает GCC считать остальную часть текущего файла заголовков файлом заголовка системы, независимо от того, где он был найден. Код, который находится перед ‘#pragma’ в файле, не затрагивается. #pragma GCC system_header не оказывает никакого эффекта в основном исходном файле.

На некоторых целевых платформах, таких как RS/6000 AIX, GCC неявно окружает все файлы заголовков системы блоком ‘extern "C"’ при компиляции как C++.