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) полным или относительным путем <dir>.

TARGET

Область видимости должна указывать на один существующий целевой объект.

SOURCE

Область видимости должна указывать на один исходный файл.

INSTALL

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

TEST

Область видимости должна указывать на один существующий тест.

CACHE

Область видимости должна указывать на одну запись кэша.

VARIABLE

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

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

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

Если задан BRIEF_DOCS или FULL_DOCS параметр, переменная устанавливается в строку, содержащую документацию для запрошенного свойства. Если документация запрошена для свойства, которое не определено, возвращается NOTFOUND.