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++.
© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-12.1.0/cpp/System-Headers.html