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

Проверка возможности сборки исходного кода C.

check_c_source_compiles

check_c_source_compiles(<code> <resultVar>
                        [FAIL_REGEX <regex1> [<regex2>...]])

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

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

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

См. также check_source_compiles() для более общего синтаксиса команды.

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

Команды компиляции и линкирования могут быть изменены путем установки следующих переменных до вызова check_c_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.

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