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/v3.31/module/CheckFunctionExists.html