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> заданному значению.