<PROJECT-NAME>_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() 调用的目录