13 Переменные среды

В этом разделе описываются переменные среды, влияющие на работу CPP. Их можно использовать для указания каталогов или префиксов для поиска файлов включения или для управления выводом зависимостей.

Обратите внимание, что вы также можете указать места для поиска, используя параметры, такие как -I, и управлять выводом зависимостей с помощью параметров, таких как -M (см. Вызов). Эти параметры имеют приоритет перед переменными среды, которые, в свою очередь, имеют приоритет перед настройками GCC.

CPATH

C_INCLUDE_PATH

CPLUS_INCLUDE_PATH

OBJC_INCLUDE_PATH

Значение каждой переменной представляет собой список каталогов, разделенных специальным символом, подобно PATH, для поиска файлов заголовков. Специальный символ PATH_SEPARATOR зависит от платформы и определяется во время сборки GCC. Для платформ на базе Microsoft Windows это точка с запятой, а для почти всех других платформ — двоеточие.

CPATH задаёт список каталогов, которые будут просматриваться так, как если бы они были указаны с помощью -I, но после любых путей, заданных с помощью параметров -I в командной строке. Эта переменная среды используется независимо от языка, который препроцессируется.

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

Во всех этих переменных пустой элемент инструктирует компилятор искать в текущем рабочем каталоге. Пустые элементы могут находиться в начале или конце пути. Например, если значение CPATH равно :/special/include, это имеет тот же эффект, что и ‘-I. -I/special/include’.

См. также Путь поиска.

DEPENDENCIES_OUTPUT

Если эта переменная установлена, её значение определяет, как выводить зависимости для Make, основанные на файлах заголовков, не относящихся к системе, обработанных компилятором. Файлы заголовков системы игнорируются в выводе зависимостей.

Значение DEPENDENCIES_OUTPUT может быть просто именем файла, в этом случае правила Make записываются в этот файл, угадывая имя целевого файла из имени исходного файла. Или значение может иметь вид ‘файл цель’, в этом случае правила записываются в файл файл с использованием цель в качестве имени целевого файла.

Другими словами, эта переменная среды эквивалентна комбинированию параметров -MM и -MF (см. Вызов), с опциональным переключателем -MT.

SUNPRO_DEPENDENCIES

Эта переменная аналогична DEPENDENCIES_OUTPUT (см. выше), за исключением того, что файлы заголовков системы не игнорируются, поэтому это подразумевает -M вместо -MM. Однако зависимость от основного входного файла опущена. См. Вызов.