Spec-Zone.ru › CMake 3.29

Проверка наличия функции

Проверка возможности подключения C-функции

check_function_exists
check_function_exists(<function> <variable>)

Проверяет, предоставляют ли библиотеки на системе функцию <function>, и сохраняет результат в <variable>, который будет создан как внутренняя переменная кэша.

Перед вызовом этой макрокоманды можно задать следующие переменные, чтобы изменить способ выполнения проверки:

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_QUIET

Новое в версии 3.1.

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

Примечание

Вместо этого модуля предпочтительнее использовать CheckSymbolExists по следующим причинам:

  • check_function_exists() не может обнаружить функции, которые встроены в заголовки или заданы как макросы.
  • check_function_exists() не может обнаружить ничего в 32-битных версиях Win32 API из-за несовпадения соглашений о вызовах.
  • check_function_exists() проверяет только компоновку, но не проверяет, объявлена ли функция в системных заголовках.

© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.29/module/CheckFunctionExists.html

Spec-Zone.ru

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