CheckFunctionExists
Проверка наличия 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_LINK_DIRECTORIES -
Добавлена в версии 3.31.
;-список путей поиска библиотек для передачи линковщику (см.
try_compile()для получения дополнительной информации).
-
CMAKE_REQUIRED_QUIET -
Добавлена в версии 3.1.
Если эта переменная имеет булево значение «истина», все сообщения о состоянии, связанные с проверкой, будут подавлены.
Примечание
Предпочтительно использовать CheckSymbolExists или CheckSourceCompiles вместо этого модуля по следующим причинам:
-
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/latest/module/CheckFunctionExists.html