set

Установите переменную обычного, кэша или среды заданному значению. Обратитесь к документации cmake-language(7) переменные для получения информации о зонах действия и взаимодействии обычных переменных и записей кэша.

Подписи этой команды, которые указывают на заполнитель <value>..., ожидают ноль или более аргументов. Несколько аргументов будут объединены как ;-список для формирования фактического значения переменной, которое должно быть установлено. Ноль аргументов приведет к тому, что обычные переменные будут сброшены. Обратитесь к команде unset(), чтобы явно сбросить переменные.

Установить обычную переменную

set(<variable> <value>... [PARENT_SCOPE])

Установите заданную <variable> в текущей функции или области каталога.

Если указан параметр PARENT_SCOPE, переменная будет установлена в области выше текущей области. Каждый новый каталог или функция создаёт новую область. Эта команда установит значение переменной в родительский каталог или вызывающую функцию (что применимо к рассматриваемому случаю). Предыдущее состояние значения переменной остаётся неизменным в текущей области (например, если она была неопределена ранее, она по-прежнему неопределена, а если у неё было значение, оно по-прежнему сохраняется).

Установить запись кэша

set(<variable> <value>... CACHE <type> <docstring> [FORCE])

Установите заданную запись кэша <variable> (запись кэша). Поскольку записи кэша предназначены для предоставления пользовательских значений, это не перезаписывает существующие записи кэша по умолчанию. Используйте параметр FORCE для перезаписи существующих записей.

<type> должно быть указано как одно из:

BOOL

Булево ON/OFF значение. cmake-gui(1) предлагает флажок.

FILEPATH

Путь к файлу на диске. cmake-gui(1) предлагает диалог выбора файла.

PATH

Путь к каталогу на диске. cmake-gui(1) предлагает диалог выбора файла.

STRING

Строка текста. cmake-gui(1) предлагает текстовое поле или выпадающий список, если свойство записи кэша STRINGS установлено.

INTERNAL

Строка текста. cmake-gui(1) не отображает внутренние записи. Они могут использоваться для постоянного хранения переменных между запусками. Использование этого типа подразумевает FORCE.

<docstring> должно быть указано как строка текста, предоставляющая краткое описание параметра для представления пользователям cmake-gui(1).

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

Возможно, запись кэша существует до вызова, но её тип не установлен, если она была создана в командной строке команды cmake(1) пользователем с помощью параметра -D<var>=<value> без указания типа. В этом случае команда set добавит тип. Кроме того, если <type> это PATH или FILEPATH, и предоставленный в командной строке <value> является относительным путём, то команда set будет рассматривать путь как относительный к текущей рабочей директории и преобразовывать его в абсолютный путь.

Установить переменную среды

set(ENV{<variable>} <value>...)

Установите текущую переменную среды процесса <variable> заданному значению.