定宽整数类型 (C++11 起)

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

工具库

语言支持 类型支持（基本类型、 RTTI） 库功能特性测试宏 (C++20) 动态内存管理 程序工具 协程支持 (C++20) 变参数函数 is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) 三路比较 (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20) is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

通用工具 日期和时间 函数对象 格式化库 (C++20) bitset hash (C++11) 关系运算符 (C++20 中弃用) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= 整数比较函数 cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20) cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) swap 与类型运算 swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) 常用词汇类型 pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) 初等字符串转换 to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

类型支持

基本类型
定宽整数类型 (C++11)
定宽浮点类型 (C++23)
ptrdiff_t size_t max_align_t (C++11) byte (C++17)	nullptr_t (C++11) offsetof NULL
数值极限
numeric_limits
C 数值极限接口
运行时类型信息
type_info type_index (C++11)	bad_typeid bad_cast

 

类型

在标头 <cstdint> 定义
int8_tint16_tint32_tint64_t (可选)	分别是宽度正好是 8、16、32 和 64 位的有符号整数类型 无填充位并对负值使用补码 （在且只有在实现直接支持该类型时才会提供） (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) // 展开成类型为 uint64_t 而值为 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++ 转译立即后随字符串字面量的字符为用户定义字面量，诸如 printf("%"PRId64"\n",n); 的 C 代码在 C++ 中非法，并在 PRId64 前要求空格。

C99 标准建议 C++ 实现不应定义上述极限、常量或格式化宏，除非在包含相对的 C 标头（stdint.h 或 inttypes.h）前（分别）定义宏 __STDC_LIMIT_MACROS、__STDC_CONSTANT_MACROS 或 __STDC_FORMAT_MACROS 。此建议未被采纳，并在 C11 中被移除。然而，某些实现（例如 glibc 2.17）尝试应用此规则，而可能需要定义 __STDC 宏； C++ 编译器可以通过在某些环境自动定义它们来做变通。

std::int8_t 可以是 signed char，std::uint8_t 也可以是 unsigned char，但两者都不能是 char（因为 char 既不视为“有符号整数类型”也不视为“无符号整数类型”）。

示例

运行此代码

#include <cstdio>
#include <cinttypes>
 
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	可选的 typedef 名与宏的要求与 C 不一致	使得一致

引用

• C++20 标准（ISO/IEC 14882:2020）：

• 17.4 Integer types [cstdint]

• 29.12.2 Header <cinttypes> synopsis [cinttypes.syn]

• C++17 标准（ISO/IEC 14882:2017）：

• 21.4 Integer types [cstdint]

• 30.11.2 Header <cinttypes> synopsis [cinttypes.syn]

• C++14 标准（ISO/IEC 14882:2014）：

• 18.4 Integer types [cstdint]

• 27.9.2 C library files [c.files]

• C++11 标准（ISO/IEC 14882:2011）：

• 18.4 Integer types [cstdint]

• 27.9.2 C library files [c.files]

参阅

• 基础类型