get_source_file_property

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

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

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

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

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

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

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

Примечание

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

См. также

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