get_property

Получение свойства.

get_property(<variable>
             <GLOBAL             |
              DIRECTORY [dir]    |
              TARGET    <target> |
              SOURCE    <source> |
              INSTALL   <file>   |
              TEST      <test>   |
              CACHE     <entry>  |
              VARIABLE>
             PROPERTY <name>
             [SET | DEFINED | BRIEF_DOCS | FULL_DOCS])

Получение одного свойства одного объекта в области видимости. Первый аргумент задаёт переменную, в которой будет храниться результат. Второй аргумент определяет область видимости, из которой нужно получить свойство. Он должен быть одним из следующих:

GLOBAL

Область видимости уникальна и не принимает имя.

DIRECTORY

Область видимости по умолчанию — текущая директория, но может быть указана другая директория (уже обработанная CMake) полным или относительным путём.

TARGET

Область видимости должна содержать имя одного существующего целевого объекта.

SOURCE

Область видимости должна содержать имя одного исходного файла.

INSTALL

Область видимости должна содержать путь к одному установленному файлу.

TEST

Область видимости должна содержать имя одного существующего теста.

CACHE

Область видимости должна содержать имя одной записи кэша.

VARIABLE

Область видимости уникальна и не принимает имя.

Необходимый PROPERTY параметр сразу же следует за именем свойства, которое нужно получить. Если свойство не задано, возвращается пустое значение, хотя некоторые свойства поддерживают наследование из родительской области видимости, если это определено (см. define_property()).

Если задан SET параметр, переменная устанавливается в булево значение, указывающее, было ли свойство установлено. Если задан DEFINED параметр, переменная устанавливается в булево значение, указывающее, было ли свойство определено, например, с помощью команды define_property(). Если задан BRIEF_DOCS или FULL_DOCS параметр, переменная устанавливается в строку, содержащую документацию запрошенного свойства. Если документация запрошена для свойства, которое не определено, возвращается NOTFOUND.