2.8 Заголовки системы

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

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

Команда -isystem добавляет свой аргумент в список директорий для поиска заголовков, как и -I. Любые заголовки, найденные в этой директории, будут считаться заголовками системы.

Все директории, названные -isystem, просматриваются после всех директорий, названных -I, независимо от их порядка в командной строке. Если одна и та же директория указана как -I и -isystem, опция -I игнорируется. GCC выведет информационное сообщение, когда это произойдет, если используется -v.

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

В очень старых системах некоторые из предопределенных системных директорий заголовков получают еще более специальное лечение. GNU C++ рассматривает код в заголовках, найденных в этих директориях, как заключённый в блок extern "C". Нет способа запросить такое поведение с помощью ‘#pragma’, или из командной строки.