Spec-Zone.ru › CMake 3.22

CheckCXXSymbolExists

Проверить, существует ли символ в качестве функции, переменной или макроса в C++.

check_cxx_symbol_exists
check_cxx_symbol_exists(<symbol> <files> <variable>)

Проверить, доступен ли <symbol> после включения заданного заголовочного файла <files> и сохранить результат в <variable>. Укажите список файлов в одном аргументе, разделенном точкой с запятой. check_cxx_symbol_exists() может использоваться для проверки символов, как это видит компилятор C++, в отличие от check_symbol_exists(), который всегда использует C компилятор.

Если заголовочные файлы определяют символ как макрос, он считается доступным и предполагается, что он работает. Если заголовочные файлы объявляют символ как функцию или переменную, то символ также должен быть доступен для компоновки. Если символ представляет собой тип, значение перечисления или шаблон C++, он не будет распознан: вместо этого используйте модуль CheckTypeSize или CheckSourceCompiles.

Примечание

Эта команда ненадежна, когда <symbol> (возможно) является перегруженной функцией. Поскольку нет надежного способа предсказать, будет ли определенная функция в среде системы перегруженной функцией или таковой на других системах, или станет таковой в будущем, рекомендуется использовать модуль CheckCXXSourceCompiles для проверки любого символа функции (если каким-то образом вы точно знаете, что проверяемая функция не перегружена на других системах или не станет таковой в будущем).

Следующие переменные могут быть установлены перед вызовом этого макроса для изменения способа выполнения проверки:

CMAKE_REQUIRED_FLAGS

строка флагов командной строки компилятора.

CMAKE_REQUIRED_DEFINITIONS

список макросов для определения (-DFOO=bar).

CMAKE_REQUIRED_INCLUDES

список путей поиска заголовочных файлов для передачи компилятору.

CMAKE_REQUIRED_LINK_OPTIONS

Новое в версии 3.14: список опций для добавления к команде компоновки.

CMAKE_REQUIRED_LIBRARIES

список библиотек для добавления к команде компоновки. См. политику CMP0075.

CMAKE_REQUIRED_QUIET

Новое в версии 3.1: выполнять без сообщений.

Например:

include(CheckCXXSymbolExists)

# Check for macro SEEK_SET
check_cxx_symbol_exists(SEEK_SET "cstdio" HAVE_SEEK_SET)
# Check for function std::fopen
check_cxx_symbol_exists(std::fopen "cstdio" HAVE_STD_FOPEN)

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.22/module/CheckCXXSymbolExists.html

Spec-Zone.ru

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