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