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

Типы

Реализация может определить имена typedef intN_t, int_fastN_t, int_leastN_t, uintN_t, uint_fastN_t, и uint_leastN_t, когда N не равно 8, 16, 32 или 64. Имена typedef вида intN_t могут быть определены только в том случае, если реализация поддерживает целочисленный тип этой ширины без заполнения. Таким образом, std::uint24_t обозначает целочисленный тип без знака с шириной ровно 24 бита.

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

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

Функциональные макросы для целочисленных констант минимальной ширины

#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 может быть signed char, а std::uint8_t может быть unsigned char, но ни то, ни другое не может быть 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:2023):
• 17.4 Целые типы [cstdint]
• 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 Синтаксис заголовка <cinttypes> [cinttypes.syn]
• Стандарт 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]

См. также

• Основные типы