Spec-Zone.ru › CMake 3.28

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

Проверить, можно ли связать функцию 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.

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

Примечание

Вместо этого модуля рекомендуется использовать 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.28/module/CheckFunctionExists.html

Spec-Zone.ru

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