<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() 调用