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

Проверить, компилируется ли данный исходный код и создается ли из него исполняемый файл.

check_source_compiles

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

Проверить, что предоставленный в <code> исходный код может быть скомпилирован как исходный файл для запрошенного языка и скомпонован в исполняемый файл (поэтому он должен содержать как минимум функцию main()). Результат будет сохранён во внутренней переменной кэша, указанной в <resultVar>, со значением true для успеха и false для неудачи. Если FAIL_REGEX указан, то неудача определяется по проверке наличия в выводе совпадений с указанными регулярными выражениями.

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

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

CMAKE_REQUIRED_FLAGS

Дополнительные флаги для компилятора. Обратите внимание, что содержимое CMAKE_<LANG>_FLAGS и его соответствующей переменной, специфичной для конфигурации, автоматически добавляется к команде компилятора до содержимого CMAKE_REQUIRED_FLAGS.

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

Список путей поиска заголовков для компилятора. Это будут единственные пути поиска заголовков, используемые try_compile(), т.е. содержимое свойства каталога INCLUDE_DIRECTORIES будет проигнорировано.

CMAKE_REQUIRED_LINK_OPTIONS

Список опций, добавляемых к команде компоновки (см. try_compile() для более подробной информации).

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

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

Проверка выполняется только один раз, а результат кэшируется в переменной, указанной в <resultVar>. Каждый последующий запуск CMake будет использовать этот кэшированный результат вместо повторной проверки, даже если <code> изменяется. Для того, чтобы принудительно перепроверить результат, необходимо вручную удалить переменную <resultVar> из кэша.