Spec-Zone.ru › CMake 3.31

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

Spec-Zone.ru

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