Spec-Zone.ru › CMake

CheckCXXSourceCompiles

Проверка возможности компиляции исходного кода C++.

check_cxx_source_compiles
check_cxx_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_cxx_source_compiles():

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/CheckCXXSourceCompiles.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API