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.