命名空间
变体
操作

固定宽度整数类型 (自 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 时，实现可以定义 typedef 名称 intN_t、int_fastN_t、int_leastN_t、uintN_t、uint_fastN_t 和 uint_leastN_t。 只有当实现支持没有填充位的该宽度的整数类型时，才可以定义 intN_t 形式的 typedef 名称。 因此，std::uint24_t 表示宽度恰好为 24 位的无符号整数类型。

当且仅当实现定义了相应的 typedef 名称时，才会定义下面列出的每个宏。 宏 INTN_C 和 UINTN_C 分别对应于 typedef 名称 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 宏，当且仅当实现定义了相应的 typedef 名称时，才会被定义。

等效于
对于 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 宏，当且仅当实现定义了相应的 typedef 名称并且具有适用于该类型的 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++ 将紧跟字符串字面量后的字符解释为用户定义的字符串字面量，因此 C 代码（例如 printf("%"PRId64"\n",n);）在 C++ 中无效，并且在 PRId64 之前需要一个空格。

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

DR 应用于 已发布行为 正确行为
LWG 2820 C++11 可选 typedef 名称和宏的要求与 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”