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
原始碼檔案屬性可能是全域可見的。有關詳細資訊,請參閱其文件。