2.3 Путь поиска

По умолчанию препроцессор сначала ищет файлы заголовков, включенные с помощью формы директивы с кавычками #include "file", относительно каталога текущего файла, а затем в предварительно настроенном списке стандартных системных каталогов. Например, если /usr/include/sys/stat.h содержит #include "types.h", GCC ищет types.h сначала в /usr/include/sys, а затем в обычном пути поиска.

Для формы с угловыми скобками #include <file>, поведение препроцессора по умолчанию заключается в поиске только в стандартных системных каталогах. Точный список каталогов поиска зависит от целевой системы, от того, как настроен GCC, и от места его установки. Вы можете найти список стандартных каталогов поиска для вашей версии CPP, вызвав её с опцией -v. Например,

cpp -v /dev/null -o /dev/null

Существует ряд командных опций, которые можно использовать для добавления дополнительных каталогов в путь поиска. Наиболее часто используемая опция — -Idir, которая заставляет препроцессор искать в каталоге dir после текущего каталога (для формы директивы с кавычками) и перед стандартными системными каталогами. Вы можете указать несколько опций -I в командной строке, в этом случае каталоги будут просматриваться слева направо.

Если вам нужна отдельная настройка путей поиска для форм директивы «#include» с кавычками и угловыми скобками, вы можете использовать опции -iquote и/или -isystem вместо -I. Подробное описание этих опций, а также других менее полезных опций, можно найти в разделе Вызов.

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

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