CheckCompilerFlag
Добавлен в версии 3.19.
Проверить один раз, поддерживает ли <lang> компилятор заданный флаг.
-
check_compiler_flag -
check_compiler_flag(<lang> <flag> <resultVar>)
Проверить один раз, что <flag> принимается компилятором <lang> без диагностических сообщений. Результат сохраняется во внутренней переменной кэша, указанной в <resultVar>, с булевым значением true для успеха и булевым значением false для неудачи.
true указывает только то, что компилятор не выдал сообщение об ошибке при задании флага. Влияние флага на результат выходит за рамки этого модуля.
Внутренне, try_compile() используется для выполнения проверки. Если CMAKE_TRY_COMPILE_TARGET_TYPE установлено в EXECUTABLE (значение по умолчанию), выполняется компиляция и компоновка исполняемого файла. Если установлено в STATIC_LIBRARY, выполняется только компиляция.
Команды компиляции и компоновки могут быть изменены путём установки любых из следующих переменных перед вызовом check_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.
Если эта переменная принимает булевое значение "истина", все сообщения состояния, связанные с проверкой, будут подавлены.
© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/latest/module/CheckCompilerFlag.html