PROJECT_IS_TOP_LEVEL

Логическая переменная, указывающая, был ли последний вызов команды project() в текущем или вышестоящем области в верхнем уровне CMakeLists.txt файла.

Некоторые модули следует включать только как часть верхнего уровня CMakeLists.txt файла, чтобы избежать непреднамеренных побочных эффектов в дереве сборки, и эту переменную можно использовать для условного выполнения такого кода. Например, рассмотрите модуль CTest, который создаёт цели и опции:

project(MyProject)
...
if(PROJECT_IS_TOP_LEVEL)
  include(CTest)
endif()

Значение переменной будет истинным в:

• корневом каталоге проекта
• корневом каталоге внешнего проекта, добавленного с помощью ExternalProject
• каталоге, добавленном с помощью add_subdirectory(), который не содержит вызов project()
• каталоге, добавленном с помощью FetchContent_MakeAvailable(), если извлеченное содержимое не содержит вызов project()

Значение переменной будет ложным в:

• каталоге, добавленном с помощью add_subdirectory(), который также содержит вызов project()
• каталоге, добавленном с помощью FetchContent_MakeAvailable(), если извлеченное содержимое содержит вызов project()