<專案名稱>_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() 呼叫的目錄