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