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

< cpp‎ | types
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
 
类型支持
基本类型
基础类型
定宽整数类型 (C++11)
数值极限
C 数值极限接口
运行时类型信息
类型特性
类型类别
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型属性
(C++11)
(C++11)
(C++14)
(C++11)
(C++11)(C++20 前)
(C++11)(C++20 中弃用)
(C++11)
类型特性常量
元函数
(C++17)
常量求值语境
受支持操作
关系与属性查询
类型修改
(C++11)(C++11)(C++11)
类型变换
(C++11)
(C++11)
(C++17)
(C++11)(C++20 前)(C++17)
 

类型

定义于头文件 <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
(可选)
足以保有指针的有符号整数类型
(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
(可选)
足以保有指针的无符号整数类型
(typedef)

宏常量

定义于头文件 <cstdint>
有符号整数:最小值
INT8_MININT16_MININT32_MININT64_MIN
(可选)
int8_tint16_tint32_tint64_t 类型对象的最小值
(宏常量)
INT_FAST8_MININT_FAST16_MININT_FAST32_MININT_FAST64_MIN
int_fast8_tint_fast16_tint_fast32_tint_fast64_t 类型对象的最小值
(宏常量)
INT_LEAST8_MININT_LEAST16_MININT_LEAST32_MININT_LEAST64_MIN
int_least8_tint_least16_tint_least32_tint_least64_t 类型对象的最小值
(宏常量)
INTPTR_MIN
(可选)
intptr_t 类型对象的最小值
(宏常量)
INTMAX_MIN
intmax_t 类型对象的最小值
(宏常量)
有符号整数:最大值
INT8_MAXINT16_MAXINT32_MAXINT64_MAX
(可选)
int8_tint16_tint32_tint64_t 类型对象的最大值
(宏常量)
INT_FAST8_MAXINT_FAST16_MAXINT_FAST32_MAXINT_FAST64_MAX
int_fast8_tint_fast16_tint_fast32_tint_fast64_t 类型对象的最大值
(宏常量)
INT_LEAST8_MAXINT_LEAST16_MAXINT_LEAST32_MAXINT_LEAST64_MAX
int_least8_tint_least16_tint_least32_tint_least64_t 类型对象的最大值
(宏常量)
INTPTR_MAX
(可选)
intptr_t 类型对象的最大值
(宏常量)
INTMAX_MAX
intmax_t 类型对象的最大值
(宏常量)
无符号整数:最大值
UINT8_MAXUINT16_MAXUINT32_MAXUINT64_MAX
(可选)
uint8_tuint16_tuint32_tuint64_t 类型对象的最大值
(宏常量)
UINT_FAST8_MAXUINT_FAST16_MAXUINT_FAST32_MAXUINT_FAST64_MAX
uint_fast8_tuint_fast16_tuint_fast32_tuint_fast64_t 类型对象的最大值
(宏常量)
UINT_LEAST8_MAXUINT_LEAST16_MAXUINT_LEAST32_MAXUINT_LEAST64_MAX
uint_least8_tuint_least16_tuint_least32_tuint_least64_t 类型对象的最大值
(宏常量)
UINTPTR_MAX
(可选)
uintptr_t 类型对象的最大值
(宏常量)
UINTMAX_MAX
uintmax_t 类型对象的最大值
(宏常量)

最小宽度整数常量的函数宏

INT8_CINT16_CINT32_CINT64_C
展开成拥有其实参所指定的值且类型分别为 int_least8_tint_least16_tint_least32_tint_least64_t提升类型的整数常量表达式
(宏函数)
INTMAX_C
展开成拥有其实参所指定的值且类型为 intmax_t 的整数常量表达式
(宏函数)
UINT8_CUINT16_CUINT32_CUINT64_C
展开成拥有其实参所指定的值且类型分别为 uint_least8_tuint_least16_tuint_least32_tuint_least64_t提升类型的整数常量表达式
(宏函数)
UINTMAX_C
展开成拥有其实参所指定的值且类型为 uintmax_t 的整数常量表达式
(宏函数)
#include <cstdint>
UINT64_C(0x123) // 展开成类型为 uint64_t 而值为 0x123 的字面量

格式化宏常量

定义于头文件 <cinttypes>

std::fprintf 系列函数的格式化宏常量

int
unsigned int
的等价者
描述 数据类型的宏




std::intx_t




std::int_leastx_t
std::int_fastx_t
std::intmax_t
std::intptr_t
x = 8 、 16 、 32 或 64
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 系列函数的格式化宏常量

int
unsigned int
的等价者
描述 数据类型的宏




std::intx_t




std::int_leastx_t
std::int_fastx_t
std::intmax_t
std::intptr_t
x = 8 、 16 、 32 或 64
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.hinttypes.h )前(分别)定义宏 __STDC_LIMIT_MACROS__STDC_CONSTANT_MACROS__STDC_FORMAT_MACROS 。此建议未被采纳,并在 C11 中被移除。然而,某些实现(例如 glibc 2.17 )尝试应用此规则,而可能需要定义 __STDC 宏; C++ 编译器可以通过在某些环境自动定义它们来做变通。

示例

#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

参阅