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 源文件属性可能是全局可见的。详情请参阅其文档。

另请参阅