Проверка компиляции исходного кода

Проверка возможности компиляции исходного кода для данного языка.

check_source_compiles

check_source_compiles(<lang> <code> <resultVar>
                      [FAIL_REGEX <regex1> [<regex2>...]]
                      [SRC_EXT <extension>])

Проверка возможности компиляции исходного кода, предоставленного в <code>, для языка кода <lang>. Результат сохраняется во внутренней переменной кэша, указанной в <resultVar>, со значениями true для успешной компиляции и false для неудачи.

Если FAIL_REGEX указано, неудача определяется по соответствию вывода компилятора любому из указанных регулярных выражений.

По умолчанию, тестовый исходный файл будет иметь расширение, соответствующее запрошенному языку. Опция SRC_EXT может быть использована для изменения этого расширения на .<extension>.

Пример на C проверяет, поддерживает ли компилятор атрибут noreturn:

set(CMAKE_TRY_COMPILE_TARGET_TYPE "STATIC_LIBRARY")

check_source_compiles(C
"#if !__has_c_attribute(noreturn)
#error \"No noreturn attribute\"
#endif"
HAVE_NORETURN)

Пример на Fortran проверяет, поддерживает ли компилятор атрибут процедуры pure:

set(CMAKE_TRY_COMPILE_TARGET_TYPE "STATIC_LIBRARY")

check_source_compiles(Fortran
"pure subroutine foo()
end subroutine"
HAVE_PURE)

Внутренне используется команда try_compile() для компиляции исходного кода. Если переменная CMAKE_TRY_COMPILE_TARGET_TYPE установлена в EXECUTABLE (по умолчанию), исходный код компилируется и линкуется как исполняемая программа. Если установлена в STATIC_LIBRARY, исходный код компилируется, но не линкуется. Во всех случаях, все функции должны быть объявлены обычным способом.

См. также check_source_runs() для запуска скомпилированного исходного кода.

Команды компиляции и линковки могут быть изменены путем установки следующих переменных до вызова check_source_compiles():

CMAKE_REQUIRED_FLAGS

Строка дополнительных флагов для компилятора. Строка должна быть разделена пробелами — использование ;-list не сработает. Содержимое CMAKE_<LANG>_FLAGS и её конфигурационно-специфических переменных автоматически добавляются к команде компилятора перед содержимым CMAKE_REQUIRED_FLAGS.

CMAKE_REQUIRED_DEFINITIONS

;-list определений компилятора в формате -DFOO или -DFOO=bar. Определение для имени, указанного в <resultVar>, также будет добавлено автоматически.

CMAKE_REQUIRED_INCLUDES

;-list путей поиска заголовков для компилятора. Это будут единственные пути поиска заголовков — содержимое свойства директории INCLUDE_DIRECTORIES будет проигнорировано.

CMAKE_REQUIRED_LINK_OPTIONS

Добавлена в версии 3.14.

;-list опций для добавления к команде линковки (см. try_compile() для получения дополнительной информации).

CMAKE_REQUIRED_LIBRARIES

;-list библиотек для добавления к команде линковки. Это могут быть имена системных библиотек или Импортированные целевые объекты (см. try_compile() для получения дополнительной информации).

CMAKE_REQUIRED_LINK_DIRECTORIES

Добавлена в версии 3.31.

;-list путей поиска библиотек для передачи линковщику (см. try_compile() для получения дополнительной информации).

CMAKE_REQUIRED_QUIET

Добавлена в версии 3.1.

Если эта переменная принимает логическое значение «истина», все сообщения об ошибках, связанные с проверкой, будут подавлены.