set

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

Подписи этой команды, которые указывают на <value>... заполнитель, ожидают ноль или более аргументов. Несколько аргументов будут объединены как ;-list для формирования фактического значения переменной, которое нужно установить. Ноль аргументов приведет к отмене обычных переменных. См. команду 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> заданному значению.