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.