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() 命令所描述的那樣。

預設情況下,原始檔的屬性將從目前原始目錄的作用域中讀取。

Added in version 3.18: 目錄作用域可以使用以下子選項之一覆寫

DIRECTORY <dir>

原始檔屬性將從 <dir> 目錄的作用域中讀取。CMake 必須已經知道該原始目錄,可能是通過呼叫 add_subdirectory() 添加它,或者 <dir> 是頂層原始目錄。相對路徑被視為相對於目前原始目錄。

TARGET_DIRECTORY <target>

原始檔屬性將從建立 <target> 的目錄作用域中讀取 (<target> 因此必須已經存在)。

使用 set_source_files_properties() 來設定屬性值。原始檔屬性通常控制檔案的建置方式。其中一個始終存在的屬性是 LOCATION

注意

GENERATED 原始檔屬性可能是全域可見的。詳情請參閱其文件。

另請參閱