Spec-Zone.ru › CMake 3.30

Проверка размера типа

Проверка размера типа

check_type_size
check_type_size(<type> <variable> [BUILTIN_TYPES_ONLY]
                                  [LANGUAGE <language>])

Проверяет существование типа и определяет его размер. Результаты сохраняются в следующих переменных:

HAVE_<variable>

Содержит значение true или false, указывающее на существование типа.

<variable>

Содержит одно из следующих значений:

<size>

Тип имеет размер, отличный от нуля <size>.

0

Тип имеет размер, зависящий от архитектуры. Это может произойти, когда CMAKE_OSX_ARCHITECTURES содержит несколько архитектур. В этом случае <variable>_CODE содержит тесты препроцессора C, сопоставляющие макросы каждой архитектуры с соответствующим размером типа. Список макросов архитектуры хранится в <variable>_KEYS, а значение для каждого ключа хранится в <variable>-<key>.

"" (пустая строка)

Тип не существует.

<variable>_CODE

Содержит код препроцессора C для определения макроса <variable> размером типа или для оставления макроса неопределённым, если тип не существует.

Параметры:

BUILTIN_TYPES_ONLY

Поддерживает только встроенные типы компилятора. Если не указано, макрос проверяет заголовки <sys/types.h>, <stdint.h>, и <stddef.h>, и сохраняет результаты в HAVE_SYS_TYPES_H, HAVE_STDINT_H, и HAVE_STDDEF_H. Проверка размера типа автоматически включает доступные заголовки, тем самым поддерживая проверку типов, определённых в заголовках.

LANGUAGE <language>

Используйте компилятор <language> для выполнения проверки. Допустимые значения C и CXX.

Несмотря на название макроса, им также можно проверить размер более сложных выражений. Например, чтобы проверить размер члена структуры, можно сделать следующее:

check_type_size("((struct something*)0)->member" SIZEOF_MEMBER)

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

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, все сообщения состояния, связанные с проверкой, будут подавлены.

CMAKE_EXTRA_INCLUDE_FILES

Список дополнительных заголовков для включения.

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

Spec-Zone.ru

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