variable_watch

Наблюдать за изменением переменной CMake.

variable_watch(<variable> [<command>])

Если указанная <variable> изменяется и не указана <command>, будет выведено сообщение, информирующее об изменении.

Если <command> указана, вместо этого будет выполнена эта команда. Команда получит следующие аргументы: COMMAND(<variable> <access> <value> <current_list_file> <stack>)

<variable>

Имя переменной, к которой осуществляется доступ.

<access>

Одно из READ_ACCESS, UNKNOWN_READ_ACCESS, MODIFIED_ACCESS, UNKNOWN_MODIFIED_ACCESS, или REMOVED_ACCESS. Значения UNKNOWN_ используются только в том случае, если переменная ещё не была установлена. После установки они больше никогда не используются во время текущего выполнения CMake, даже если переменная позже будет сброшена.

<value>

Значение переменной. При изменении это новое (изменённое) значение переменной. При удалении значение пустое.

<current_list_file>

Полный путь к файлу, выполняющему доступ.

<stack>

Список абсолютных путей всех файлов, находящихся в текущей стеке включения файлов, начиная с самого нижнего файла и заканчивая обрабатываемым файлом (то есть, current_list_file).

Обратите внимание, что для некоторых доступов, таких как list(APPEND), наблюдатель выполняется дважды: сначала с чтением, а затем с записью. Также обратите внимание, что запрос if(DEFINED) переменной не регистрируется как доступ и наблюдатель не выполняется.

Наблюдение за переменными с помощью этой команды возможно только для переменных, не являющихся кэш-переменными. Доступ к кэш-переменным никогда не отслеживается. Однако, существование кэш-переменной var приводит к тому, что обращение к некэш-переменной var не использует префикс UNKNOWN_, даже если некэш-переменная var никогда не существовала.