Целочисленные типы фиксированной ширины (начиная с C++11)

Типы

Для каждого из следующих имён typedef, помеченных как (необязательно), реализация определяет это имя тогда и только тогда, когда она предоставляет соответствующий тип.

Макроконстанты

Для каждого из следующих макросов, помеченных как (присутствует при определённых условиях), реализация определяет этот макрос тогда и только тогда, когда она определяет соответствующее имя typedef.

Функциональные макросы

Для каждого из следующих макросов, помеченных как (присутствует при определённых условиях), реализация определяет этот макрос тогда и только тогда, когда она определяет соответствующее имя typedef.

#include <cstdint>
UINT64_C(0x123) // expands to a literal of type uint_least64_t and value 0x123

Макроконстанты форматирования

Константы форматирования для семейства функций std::fprintf

Каждый из перечисленных здесь макросов PRI определён тогда и только тогда, когда реализация определяет соответствующее имя typedef.

Константы форматирования для семейства функций std::fscanf

Каждый из перечисленных здесь макросов SCN определён тогда и только тогда, когда реализация определяет соответствующее имя typedef и имеет подходящий модификатор длины std::fscanf для этого типа.

Примечания

Поскольку C++ интерпретирует символ, непосредственно следующий за строковым литералом, как пользовательский строковый литерал, код C, например printf("%"PRId64"\n",n);, недопустим в C++ и требует пробела перед PRId64.

Стандарт C99 рекомендует реализациям C++ не определять приведённые выше макросы пределов, констант и форматов, если только макросы __STDC_LIMIT_MACROS, __STDC_CONSTANT_MACROS или __STDC_FORMAT_MACROS (соответственно) не определены до включения соответствующего заголовочного файла C (stdint.h или inttypes.h). Эта рекомендация не была принята ни одним стандартом C++ и была удалена в C11. Однако некоторые реализации (например, glibc 2.17) пытаются применять это правило, поэтому может потребоваться определить макросы __STDC; компиляторы C++ в некоторых случаях могут пытаться обойти это ограничение, определяя их автоматически.

std::int8_t может быть signedchar, а std::uint8_t может быть unsignedchar, но ни один из них не может быть char независимо от его знаковости (поскольку char не считается ни «знаковым целочисленным типом», ни «беззнаковым целочисленным типом»).

Пример

#include <cinttypes>
#include <cstdio>

int main()
{
    std::printf("%zu\n", sizeof(std::int64_t));
    std::printf("%s\n", PRId64);
    std::printf("%+" PRId64 "\n", INT64_MIN);
    std::printf("%+" PRId64 "\n", INT64_MAX);
    
    std::int64_t n = 7;
    std::printf("%+" PRId64 "\n", n);
}

8
lld
-9223372036854775808
+9223372036854775807
+7

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

Ссылки

• Стандарт C++23 (ISO/IEC 14882:2024):
• 17.4.1 Обзор заголовочного файла <cstdint> [cstdint.syn]
• 31.13.2 Обзор заголовочного файла <cinttypes> [cinttypes.syn]
• Стандарт C++20 (ISO/IEC 14882:2020):
• 17.4 Целочисленные типы [cstdint]
• 29.12.2 Обзор заголовочного файла <cinttypes> [cinttypes.syn]
• Стандарт C++17 (ISO/IEC 14882:2017):
• 21.4 Целочисленные типы [cstdint]
• 30.11.2 Файлы библиотеки C [c.files]
• Стандарт C++14 (ISO/IEC 14882:2014):
• 18.4 Целочисленные типы [cstdint]
• 27.9.2 Файлы библиотеки C [c.files]
• Стандарт C++11 (ISO/IEC 14882:2011):
• 18.4 Целочисленные типы [cstdint]
• 27.9.2 Файлы библиотеки C [c.files]

См. также

• Фундаментальные типы