Spec-Zone.ru › GCC 5 CPP

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 записываются в этот файл, предполагая имя целевого файла по имени исходного файла. Или значение может иметь вид ‘file target’, в этом случае правила записываются в файл file с использованием target в качестве имени целевого файла.

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

SUNPRO_DEPENDENCIES

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

Далее: GNU Free Documentation License, Предыдущее: Вызов, Наверх: Наверх [Содержание][Индекс]

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-5.5.0/cpp/Environment-Variables.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API