INCLUDE_DIRECTORIES

預處理器包含檔案搜尋目錄列表。

此屬性指定目前為止提供給 include_directories() 命令的目錄列表。

此屬性用於填充 INCLUDE_DIRECTORIES 目標屬性,產生器使用此屬性來設定編譯器的包含目錄。

除了接受來自該命令的值之外,也可以使用 set_property() 命令直接在任何目錄上設定值,並且可以使用 set_directory_properties() 命令在目前目錄上設定值。目錄從其父目錄(如果有的話)取得其初始值。INCLUDE_DIRECTORIES 目標屬性的初始值來自此屬性的值。目錄和目標屬性值都會被對 include_directories() 命令的呼叫所調整。然而,對 set_property()set_directory_properties() 的呼叫將更新目錄屬性值,而不會更新目標屬性值。因此,直接屬性更新必須在呼叫 add_executable()add_library() 之前進行,以影響它們所針對的目標。

目標屬性值由產生器使用,以設定編譯器的包含路徑。

INCLUDE_DIRECTORIES 的內容可以使用「產生器表達式」,語法為 $<...>。有關可用的表達式,請參閱 cmake-generator-expressions(7) 手冊。有關定義建置系統屬性的更多資訊,請參閱 cmake-buildsystem(7) 手冊。