include_guard

Обеспечивает включение защитной директивы для файла, который в данный момент обрабатывается CMake.

include_guard([DIRECTORY|GLOBAL])

Настраивает защитную директиву для текущего файла CMake (см. документацию переменной CMAKE_CURRENT_LIST_FILE).

CMake завершит обработку текущего файла в месте расположения команды include_guard(), если текущий файл уже был обработан для соответствующего контекста (см. ниже). Это обеспечивает функциональность, аналогичную защитным директивам, обычно используемым в заголовках исходных файлов, или директиве #pragma once. Если текущий файл был обработан ранее для соответствующего контекста, эффект будет таким, как если бы была вызвана команда return(). Не вызывайте эту команду внутри функции, определенной в текущем файле.

Может быть предоставлен необязательный аргумент, определяющий область действия защиты. Возможные значения для параметра:

DIRECTORY

Защитная директива применяется в текущем каталоге и ниже. Файл будет включён только один раз в рамках текущего каталога, но может быть включён снова другими файлами за пределами этого каталога (например, родительским каталогом или другим каталогом, не подключенным через add_subdirectory() или include() из текущего файла или его дочерних элементов).

GLOBAL

Защитная директива применяется глобально ко всему построению. Текущий файл будет включён только один раз независимо от области действия.

Если аргументы не указаны, include_guard имеет такой же область действия, как и переменная, что означает, что эффект защитной директивы изолируется последней областью действия функции или текущим каталогом, если внутренние области действия функций отсутствуют. В этом случае поведение команды такое же, как:

if(__CURRENT_FILE_VAR__)
  return()
endif()
set(__CURRENT_FILE_VAR__ TRUE)