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 вместо этого.

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

CMAKE_REQUIRED_FLAGS

Строка дополнительных флагов, которые необходимо передать компилятору. Строка должна быть разделена пробелами; ;-list не сработает. Содержимое CMAKE_<LANG>_FLAGS и его соответствующей переменной, специфичной для конфигурации, автоматически добавляются к команде компилятора перед содержимым CMAKE_REQUIRED_FLAGS.

CMAKE_REQUIRED_DEFINITIONS

;-list определений компилятора в формате -DFOO или -DFOO=bar. Определение для имени, указанного <resultVar>, также будет автоматически добавлено.

CMAKE_REQUIRED_INCLUDES

;-list путей поиска заголовков, которые необходимо передать компилятору. Это будут единственные пути поиска заголовков, используемые; содержимое свойства каталога INCLUDE_DIRECTORIES будет проигнорировано.

CMAKE_REQUIRED_LINK_OPTIONS

Новое в версии 3.14.

;-list опций, которые нужно добавить к команде линковки (см. try_compile() для получения дополнительных сведений).

CMAKE_REQUIRED_LIBRARIES

;-list библиотек, которые нужно добавить к команде линковки. Это могут быть имена системных библиотек или Импортированные цели (см. try_compile() для получения дополнительных сведений).

CMAKE_REQUIRED_QUIET

Новое в версии 3.1.

Если эта переменная принимает логическое значение true, все сообщения о статусе, связанные с проверкой, будут подавлены.

Например:

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)