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 никогда не существовала.