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

Строка дополнительных флагов для передачи компилятору. Строка должна быть разделена пробелами — ;-список не будет работать. Содержимое 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.

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

Например:

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)