Просмотр кода страницы Stdint.h

{{Стандартная библиотека Си}}{{lowercase}}

'''stdint.h''' — [[заголовочный файл]] [[Стандартная библиотека языка Си|стандартной библиотеки языка Си]], введённый стандартом [[C99]]. Заголовочный файл объявляет несколько [[Целочисленное программирование|целочисленных]] типов и [[макрос]]ов.<ref name="stdc">{{Cite web |url=http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1124.pdf |title=ISO/IEC 9899:1999 |access-date=2011-08-05 |archive-date=2011-08-22 |archive-url=https://www.webcitation.org/618HUIDTw?url=http://www.open-std.org/JTC1/SC22/WG14/www/docs/n1124.pdf |deadlink=no }}</ref>

== Типы ==

Заголовочный файл объявляет целочисленные [[Тип данных|типы]], которые имеют заданный размер, имеют заданный минимальный размер и которые являются наиболее быстрыми при использовании.<ref name="stdc" /> В дополнение к ним стандарт объявляет макросы, устанавливающие размер этих типов. Платформа должна поддерживать, как минимум, ряд целочисленных типов заданных размеров:

{| class="wikitable"
|-
!Тип !!Разрядность !! Набор значений
|-
|int_least8_t || как минимум, 8 бит || [-128;127]
|-
|int_least16_t || как минимум, 16 бит || [-32768; 32767]
|-
|int_least32_t || как минимум, 32 бита || [-2147483648; 2147483647]
|-
|int_least64_t || как минимум, 64 бита || [-(2^63); 2^63 - 1]
|-
|uint_least8_t || как минимум, 8 бит || [0; 255]
|-
|uint_least16_t || как минимум, 16 бит || [0; 65535]
|-
|uint_least32_t || как минимум, 32 бита || [0; 4294967295]
|-
|uint_least64_t || как минимум, 64 бита || [0; 2^64 - 1]
|-
|int_fast8_t || как минимум, 8 бит || [-128; 127]
|-
|int_fast16_t || как минимум, 16 бит || [-32768; 32767]
|-
|int_fast32_t || как минимум, 32 бита || [-2147483648; 2147483647]
|-
|int_fast64_t || как минимум, 64 бита || [-(2^63); 2^63 - 1]
|-
|uint_fast8_t || как минимум, 8 бит || [0; 255]
|-
|uint_fast16_t || как минимум, 16 бит || [0; 65535]
|-
|uint_fast32_t || как минимум, 32 бита || [0; 4294967295]
|-
|uint_fast64_t || как минимум, 64 бита || [0; 2^64 - 1]
|}

'''Типы с точной шириной.'''

Не все системы могут поддерживать все эти типы.
{| class="wikitable"
|-
!Тип !! Описание 
|-
|int8_t || 8-битовый со знаком
|-
|int16_t || 16-битовый со знаком
|-
|int32_t || 32-битовый со знаком
|-
|int64_t || 64-битовый со знаком
|-
|uint8_t || 8-битовый без знака
|-
|uint16_t || 16-битовый без знака
|-
|uint32_t || 32-битовый без знака
|-
|uint64_t || 64-битовый без знака
|}

Заданные типы имеют ширину в точности 8, 16, 32 и 64 бита соответственно.<ref name="stdc" /> Приставка <code>u</code> означает, что этот тип является беззнаковым и содержит целые числа, как минимум, от нуля до <math>2^N - 1</math> включительно. Таким образом, тип <code>uint_least8_t</code> должен существовать и содержать числа от нуля до 255 включительно.

Платформа может поддерживать [[Указатель (тип данных)|указатели]] на знаковые и беззнаковые целочисленные типы: <code>intptr_t</code> и <code>uintptr_t</code>.<ref name="stdc" />
Платформа обязана в рамках стандарта С99 поддерживать следующие типы: <code>intmax_t</code>, <code>uintmax_t</code>, которые могут представлять максимальные целочисленные значения.

== Макросы ==
Заголовочный файл объявляет наборы макросов, которые содержат минимальные и максимальные значения целочисленных типов.<ref name="stdc" />
Чтобы получить имя, представляющее минимальное или максимальное значение данного типа, возьмите имя типа, замените _t на _MIN или _MAX и переведите все символы в верхний регистр. Например, наименьшим значением для типа int32_t является INT32_MIN, а наибольшим значением для типа uint_fast16_t - UINT_FAST16_MAX.
{{переработать раздел|дата=2015-10-17}}{{проверить факты|дата=2015-10-17}}<!-- прописанные в таблице значения могут принимать другие значения!!! -->
{| class="wikitable"
|-
!Макрос !! Значение
|-
|INT''x''_MIN ||<math>-2^{x-1}</math>
|-
|INT''x''_MAX ||<math>2^{x-1}-1</math>
|-
|UINT''x''_MAX ||<math>2^x-1</math>
|-
|INT_LEAST''x''_MIN ||<math>-2^{x-1}</math>
|-
|INT_LEAST''x''_MAX ||<math>2^{x-1}-1</math>
|-
|UINT_LEAST''x''_MAX ||<math>2^x-1</math>
|-
|INT_FAST''x''_MIN ||<math>-2^{x-1}</math>
|-
|INT_FAST''x''_MAX ||<math>2^{x-1}-1</math>
|-
|UINT_FAST''x''_MAX ||<math>2^x-1</math>
|-
|INTPTR_MIN || INT''x''_MIN, зависит от платформы
|-
|INTPTR_MAX || INT''x''_MAX, зависит от платформы
|-
|UINTPTR_MAX || UINT''x''_MAX, зависит от платформы
|-
|INTMAX_MIN ||<math>-2^{63}</math>
|-
|INTMAX_MAX || <math>2^{63}-1</math>
|-
|UINTMAX_MAX || <math>2^{64}-1</math>
|-
|PTRDIFF_MIN || INTPTR_MIN
|-
|PTRDIFF_MAX || INTPTR_MAX
|-
|SIZE_MAX<ref>Размер типа <code>size_t</code></ref> || UINTPTR_MAX
|}

Стандарт также определяет размер типов [[Signal.h|sig_atomic_t]], который может содержать значения либо [-128; 127], либо [0; 255]. Для типа <code>wchar_t</code> установлены такие же ограничения, только они являются минимальными. Тип <code>wint_t</code>, если определён, должен содержать, как минимум, либо значения [-32768; 32767], либо [0; 65535].

Макросы <code>INT''x''_C(value)</code>, <code>INTMAX_C(value)</code>, <code>UINTMAX_C(value)</code> должны раскрываться в целочисленные константные выражения со значением value и с размерностью INT_LEAST''x''_T, <code>intmax_t</code> и <code>uintmax_t</code> соответственно. К примеру, на 64-разрядной машине выражение UINT64_C(123) должно преобразоваться в константу <code>123ULL</code>.<ref name="stdc" />

== Примечания ==
{{примечания}}