<PROJECT-NAME>_IS_TOP_LEVEL

添加于版本 3.21。

一个布尔变量，指示命名的项目是否在顶层 CMakeLists.txt 文件中被调用。

要从当前目录范围或以上范围内最近一次调用 project() 获取值，请参阅 PROJECT_IS_TOP_LEVEL 变量。

变量值在以下情况下为真：

• 项目的顶层目录

• 通过 ExternalProject 添加的外部项目的顶层目录

• 通过 add_subdirectory() 添加的目录，且该目录不包含 project() 调用

• 通过 FetchContent_MakeAvailable() 添加的目录，如果获取的内容不包含 project() 调用

变量值在以下情况下为假：

• 通过 add_subdirectory() 添加的目录，且该目录也包含 project() 调用

• 通过 FetchContent_MakeAvailable() 添加的目录，如果获取的内容包含 project() 调用