<專案名稱>_IS_TOP_LEVEL

在版本 3.21 中新增。

一個布林變數，指示具名的專案是否在頂層 CMakeLists.txt 檔案中被呼叫。

若要從當前目錄範圍或以上範圍中最近一次呼叫 project() 取得值，請參閱 PROJECT_IS_TOP_LEVEL 變數。

變數值在以下情況會是 true：

• 專案的頂層目錄

• 由 ExternalProject 新增的外部專案的頂層目錄

• 由 add_subdirectory() 新增的目錄，且該目錄不包含 project() 呼叫

• 由 FetchContent_MakeAvailable() 新增的目錄，如果提取的內容不包含 project() 呼叫

變數值在以下情況會是 false：

• 由 add_subdirectory() 新增的目錄，且該目錄也包含 project() 呼叫

• 由 FetchContent_MakeAvailable() 新增的目錄，如果提取的內容包含 project() 呼叫