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.22/command/get_source_file_property.html