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.