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

另請參閱