get_source_file_property

Получение свойства исходного файла.

get_source_file_property(<variable> <file>
                         [DIRECTORY <dir> | TARGET_DIRECTORY <target>]
                         <property>)

Получает свойство из исходного файла. Значение свойства сохраняется в указанном <variable>. Если свойство исходного файла не найдено, поведение зависит от того, определено ли оно как INHERITED свойство или нет (см. define_property()). Ненаследуемые свойства установят variable в NOTFOUND, в то время как наследуемые свойства будут искать соответствующий родительский контекст, как описано для команды define_property(), и если свойство по-прежнему не найдено, variable будет установлено в пустую строку.

По умолчанию свойство исходного файла читается из контекста текущей исходной директории.

Новое в версии 3.18: Контекст директории может быть переопределён одним из следующих подвариантов:

DIRECTORY <dir>: Свойство исходного файла будет читаться из контекста директории <dir>. CMake должен уже знать об этой исходной директории, либо добавив её с помощью вызова add_subdirectory(), либо <dir> являясь корневой исходной директорией. Относительные пути рассматриваются как относительные к текущей исходной директории.
TARGET_DIRECTORY <target>: Свойство исходного файла будет читаться из контекста директории, в которой <target> было создано (<target> должно, следовательно, уже существовать).

Используйте set_source_files_properties() для установки значений свойств. Свойства исходных файлов обычно контролируют, как файл строится. Одно свойство, которое всегда присутствует, это LOCATION.

См. также более общую команду get_property().

Примечание

Свойство исходного файла GENERATED может быть глобально видимым. Для получения подробностей см. его документацию.

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.21/command/get_source_file_property.html