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

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

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

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

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