include

Загрузить и выполнить код CMake из файла или модуля.

include(<file|module> [OPTIONAL] [RESULT_VARIABLE <var>]
                      [NO_POLICY_SCOPE] [NO_DIAGNOSTIC_SCOPE])

Загружает и выполняет код CMake из указанного файла. Чтение и запись переменных выполняются в области видимости вызывающей стороны (динамическая область видимости). Если присутствует OPTIONAL, ошибка не возникает, если файл не существует. Если задано RESULT_VARIABLE, переменной <var> будет присвоено полное имя включённого файла или NOTFOUND, если операция не удалась.

Если вместо файла указан модуль, файл с именем <modulename>.cmake сначала ищется в CMAKE_MODULE_PATH, а затем в каталоге модулей CMake. Есть одно исключение: если файл, вызывающий include(), сам находится во встроенном каталоге модулей CMake, то сначала поиск выполняется во встроенном каталоге модулей CMake, а затем в CMAKE_MODULE_PATH. См. также политику CMP0017.

Обсуждение параметра NO_POLICY_SCOPE см. в документации команды cmake_policy().

Обсуждение параметра NO_DIAGNOSTIC_SCOPE см. в документации команды cmake_diagnostic().