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