命名空间
变体
操作

固定宽度整型 （C++11 起）

来自 cppreference.cn
< cpp‎ | 类型
 
C++
 
工具库
通用工具
关系运算符 (C++20 中弃用)
 
类型支持
基本类型
固定宽度整型 (C++11)
定宽浮点类型 (C++23)
(C++11)    
(C++17)
数值极限
C 数值极限接口
运行时类型信息
 

目录

[编辑] 类型

定义于头文件 <cstdint>
int8_tint16_tint32_tint64_t
（可选）
 宽度分别为恰好 8、16、32 和 64 位的有符号整型
没有填充位，对负值使用 2 的补码
（当且仅当实现直接支持该类型时才提供）
(typedef) [编辑]
int_fast8_tint_fast16_tint_fast32_tint_fast64_t
 宽度至少为 8、16、32 和 64 位的最快有符号整型
(typedef) [编辑]
int_least8_tint_least16_tint_least32_tint_least64_t
 宽度至少为 8、16、32 和 64 位的最小有符号整型
(typedef) [编辑]
intmax_t
 最大宽度有符号整型
(typedef) [编辑]
intptr_t
（可选）
 能够容纳 void 指针的有符号整型
(typedef) [编辑]
uint8_tuint16_tuint32_tuint64_t
（可选）
 宽度分别为恰好 8、16、32 和 64 位的无符号整型
（当且仅当实现直接支持该类型时才提供）
(typedef) [编辑]
uint_fast8_tuint_fast16_tuint_fast32_tuint_fast64_t
 宽度至少为 8、16、32 和 64 位的最快无符号整型
(typedef) [编辑]
uint_least8_tuint_least16_tuint_least32_tuint_least64_t
 宽度至少为 8、16、32 和 64 位的最小无符号整型
(typedef) [编辑]
uintmax_t
 最大宽度无符号整型
(typedef) [编辑]
uintptr_t
（可选）
 能够容纳 void 指针的无符号整型
(typedef) [编辑]

当 N 不是 8、16、32 或 64 时，实现可以定义类型别名 intN_t、int_fastN_t、int_leastN_t、uintN_t、uint_fastN_t 和 uint_leastN_t。只有当实现支持无填充位的指定宽度的整型时，才可以定义 intN_t 形式的类型别名。因此，std::uint24_t 表示宽度恰好为 24 位的无符号整型。

下面列出的每个宏都当且仅当实现定义了相应的类型别名时才被定义。宏 INTN_C 和 UINTN_C 分别对应于类型别名 int_leastN_t 和 uint_leastN_t。

[编辑] 宏常量

定义于头文件 <cstdint>
有符号整数：最小值
INT8_MININT16_MININT32_MININT64_MIN
（可选）
 std::int8_t、std::int16_t、std::int32_t 和 std::int64_t 的最小值
(宏常量) [编辑]
INT_FAST8_MININT_FAST16_MININT_FAST32_MININT_FAST64_MIN
 std::int_fast8_t、std::int_fast16_t、std::int_fast32_t 和 std::int_fast64_t 的最小值
(宏常量) [编辑]
INT_LEAST8_MININT_LEAST16_MININT_LEAST32_MININT_LEAST64_MIN
 std::int_least8_t、std::int_least16_t、std::int_least32_t 和 std::int_least64_t 的最小值
(宏常量) [编辑]
INTPTR_MIN
（可选）
 std::intptr_t 的最小值
(宏常量) [编辑]
INTMAX_MIN
 std::intmax_t 的最小值
(宏常量) [编辑]
有符号整数：最大值
INT8_MAXINT16_MAXINT32_MAXINT64_MAX
（可选）
 std::int8_t、std::int16_t、std::int32_t 和 std::int64_t 的最大值
(宏常量) [编辑]
INT_FAST8_MAXINT_FAST16_MAXINT_FAST32_MAXINT_FAST64_MAX
 std::int_fast8_t、std::int_fast16_t、std::int_fast32_t 和 std::int_fast64_t 的最大值
(宏常量) [编辑]
INT_LEAST8_MAXINT_LEAST16_MAXINT_LEAST32_MAXINT_LEAST64_MAX
 std::int_least8_t、std::int_least16_t、std::int_least32_t 和 std::int_least64_t 的最大值
(宏常量) [编辑]
INTPTR_MAX
（可选）
 std::intptr_t 的最大值
(宏常量) [编辑]
INTMAX_MAX
 std::intmax_t 的最大值
(宏常量) [编辑]
无符号整数：最大值
UINT8_MAXUINT16_MAXUINT32_MAXUINT64_MAX
（可选）
 std::uint8_t、std::uint16_t、std::uint32_t 和 std::uint64_t 的最大值
(宏常量) [编辑]
UINT_FAST8_MAXUINT_FAST16_MAXUINT_FAST32_MAXUINT_FAST64_MAX
 std::uint_fast8_t、std::uint_fast16_t、std::uint_fast32_t 和 std::uint_fast64_t 的最大值
(宏常量) [编辑]
UINT_LEAST8_MAXUINT_LEAST16_MAXUINT_LEAST32_MAXUINT_LEAST64_MAX
 std::uint_least8_t、std::uint_least16_t、std::uint_least32_t 和 std::uint_least64_t 的最大值
(宏常量) [编辑]
UINTPTR_MAX
（可选）
 std::uintptr_t 的最大值
(宏常量) [编辑]
UINTMAX_MAX
 std::uintmax_t 的最大值
(宏常量) [编辑]

[编辑] 最小宽度整型常量的函数宏

INT8_CINT16_CINT32_CINT64_C
 展开为一个整型常量表达式，其值为其参数指定的值，并且其类型是 std::int_least8_t、std::int_least16_t、std::int_least32_t 和 std::int_least64_t 对应的提升类型
(函数宏) [编辑]
INTMAX_C
 展开为一个整型常量表达式，其值为其参数指定的值，类型为 std::intmax_t
(函数宏) [编辑]
UINT8_CUINT16_CUINT32_CUINT64_C
 展开为一个整型常量表达式，其值为其参数指定的值，并且其类型是 std::uint_least8_t、std::uint_least16_t、std::uint_least32_t 和 std::uint_least64_t 对应的提升类型
(函数宏) [编辑]
UINTMAX_C
 展开为一个整型常量表达式，其值为其参数指定的值，类型为 std::uintmax_t
(函数宏) [编辑]
#include <cstdint>
UINT64_C(0x123) // expands to a literal of type uint_least64_t and value 0x123

[编辑] 格式宏常量

定义于头文件 <cinttypes>

[编辑] std::fprintf 函数族的格式常量

这里列出的每个 PRI 宏都当且仅当实现定义了相应的类型别名时才被定义。

等效于
对于 int 或
unsigned int 		描述 数据类型的宏




std::intx_t
std::int_leastx_t
std::int_fastx_t
std::intmax_t
std::intptr_t
d 输出有符号十进制整数值 PRIdx PRIdLEASTx PRIdFASTx PRIdMAX PRIdPTR
i PRIix PRIiLEASTx PRIiFASTx PRIiMAX PRIiPTR
u 输出无符号十进制整数值 PRIux PRIuLEASTx PRIuFASTx PRIuMAX PRIuPTR
o 输出无符号八进制整数值 PRIox PRIoLEASTx PRIoFASTx PRIoMAX PRIoPTR
x 输出无符号小写十六进制整数值 PRIxx PRIxLEASTx PRIxFASTx PRIxMAX PRIxPTR
X 输出无符号大写十六进制整数值 PRIXx PRIXLEASTx PRIXFASTx PRIXMAX PRIXPTR

[编辑] std::fscanf 函数族的格式常量

这里列出的每个 SCN 宏都当且仅当实现定义了相应的类型别名并且该类型具有合适的 std::fscanf 长度修饰符时才被定义。

等效于
对于 int 或
unsigned int 		描述 数据类型的宏




std::intx_t
std::int_leastx_t
std::int_fastx_t
std::intmax_t
std::intptr_t
d 输入有符号十进制整数值 SCNdx SCNdLEASTx SCNdFASTx SCNdMAX SCNdPTR
i 输入有符号整数值 SCNix SCNiLEASTx SCNiFASTx SCNiMAX SCNiPTR
u 输入无符号十进制整数值 SCNux SCNuLEASTx SCNuFASTx SCNuMAX SCNuPTR
o 输入无符号八进制整数值 SCNox SCNoLEASTx SCNoFASTx SCNoMAX SCNoPTR
x 输入无符号十六进制整数值 SCNxx SCNxLEASTx SCNxFASTx SCNxMAX SCNxPTR

[编辑] 注记

因为 C++ 将字符串字面量后面的字符立即解释为用户定义字符串字面量，所以像 printf("%"PRId64"\n",n); 这样的 C 代码在 C++ 中是无效的，需要在 PRId64 前加一个空格。

C99 标准建议 C++ 实现不应定义上述限制、常量或格式宏，除非在包含相关的 C 头文件（stdint.h 或 inttypes.h）之前定义了宏 __STDC_LIMIT_MACROS、__STDC_CONSTANT_MACROS 或 __STDC_FORMAT_MACROS（分别）。此建议未被任何 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++ 标准。

缺陷报告 应用于 发布时的行为 正确的行为
LWG 2820 C++11 可选类型别名和宏的要求与 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 头文件 <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]

[编辑] 另请参阅

C 文档 关于 固定宽度整型
取自 "https://cppreference.cn/mwiki/index.php?title=cpp/types/integer&oldid=169669"