CheckCCompilerFlag

Проверка поддержки заданного флага C-компилятором.

check_c_compiler_flag

check_c_compiler_flag(<flag> <resultVar>)

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

true указывает только на то, что компилятор не выдал сообщение об ошибке при использовании данного флага. Влияние флага на компиляцию не рассматривается в данном модуле.

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

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

Команды компиляции и компоновки могут быть изменены путём установки следующих переменных до вызова check_c_compiler_flag(). Неизвестные флаги в этих переменных могут привести к ложноотрицательному результату.

CMAKE_REQUIRED_FLAGS

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

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

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

CMAKE_REQUIRED_LINK_OPTIONS

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

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

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_LINK_DIRECTORIES

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

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

CMAKE_REQUIRED_QUIET

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

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