Проверка наличия символа C++

Проверка, существует ли символ в виде функции, переменной или макроса в 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 или CheckCXXSourceCompiles вместо этого.

Примечание

Эта команда ненадежна, когда <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.20/module/CheckCXXSymbolExists.html