Spec-Zone.ru › CMake 3.30

Проверка наличия символа 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 или CheckSourceCompiles вместо него.

Примечание

Эта команда ненадежна, когда <symbol> (возможно) является перегруженной функцией. Поскольку нет надёжного способа предсказать, будет ли данная функция в системной среде определена как перегруженная функция или станет таковой на других системах или в будущем, рекомендуется использовать модуль 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_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)

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

Spec-Zone.ru

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