std::size_t

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

实用工具库

语言支持 类型支持 (基本类型，RTTI) 库特性测试宏 (C++20) 程序实用工具 可变参数函数 initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) 协程支持 (C++20) 契约式支持 (C++26) 三路比较 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_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (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 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)

 

类型支持

基本类型
固定宽度整数类型 (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

 

定义于头文件 <cstddef>
定义于头文件 <cstdio>
定义于头文件 <cstdlib>
定义于头文件 <cstring>
定义于头文件 <ctime>
定义于头文件 <cuchar>		(自 C++17 起)
定义于头文件 <cwchar>
typedef /* 实现定义 */ size_t;

std::size_t 是以下运算符结果的无符号整数类型

• sizeof

sizeof... alignof

(自 C++11 起)

如果程序尝试形成过大的类型（即，其对象表示中的字节数超过了 std::size_t 中可表示的最大值），则程序是非良构的。

std::size_t 的位宽不小于 16。

(自 C++11 起)

注解

std::size_t 可以存储任何类型（包括数组）的理论上可能的最大对象大小。在许多平台（分段寻址系统是例外）上，std::size_t 可以安全地存储任何非成员指针的值，在这种情况下，它与 std::uintptr_t 同义。

std::size_t 通常用于数组索引和循环计数。对于数组索引使用其他类型（例如 unsigned int）的程序可能在例如 64 位系统上失败，当索引超过 UINT_MAX 或如果它依赖于 32 位模运算。

当索引 C++ 容器（例如 std::string, std::vector 等）时，适当的类型是此类容器提供的嵌套类型 size_type。它通常被定义为 std::size_t 的同义词。

std::size_t 的声明是否在任何其他标准库头文件中可用是未指定的。即使标准要求使用 std::size_t，实现也可能避免引入此名称。

std::size_t 的整数字面量后缀是 z 或 Z 与 u 或 U 的任意组合（即 zu、zU、Zu、ZU、uz、uZ、Uz 或 UZ）。

(自 C++23 起)

示例

运行此代码

#include <array>
#include <cstddef>
#include <iostream>
 
int main()
{
    std::array<std::size_t, 10> a;
 
    // Example with C++23 std::size_t literal
    for (auto i = 0uz; i != a.size(); ++i)
        std::cout << (a[i] = i) << ' ';
    std::cout << '\n';
 
    // Example of decrementing loop
    for (std::size_t i = a.size(); i--;)
        std::cout << a[i] << ' ';
    std::cout << '\n';
 
    // Note the naive decrementing loop:
    //  for (std::size_t i = a.size() - 1; i >= 0; --i) ...
    // is an infinite loop, because unsigned numbers are always non-negative
}

输出

0 1 2 3 4 5 6 7 8 9
9 8 7 6 5 4 3 2 1 0

缺陷报告

以下行为更改缺陷报告被追溯应用于先前发布的 C++ 标准。

DR	应用于	已发布行为	正确行为
CWG 1122	C++98	std::size_t 被循环定义	它是实现定义的
CWG 1464	C++98	对象大小可能无法在 std::size_t 中表示	此类类型是非良构的

参考

• C++23 标准 (ISO/IEC 14882:2024)

• 6.8.4 复合类型 [basic.compound] (p: 79-80)

• 7.6.2.5 Sizeof [expr.sizeof] (p: 136)

• 7.6.2.6 Alignof [expr.alignof] (p: 136)

• 17.2.4 尺寸、对齐和偏移 [support.types.layout] (p: 504-505)

• C++20 标准 (ISO/IEC 14882:2020)

• 6.8.3 复合类型 [basic.compound] (p: 75-76)

• 7.6.2.5 Sizeof [expr.sizeof] (p: 129-130)

• 7.6.2.6 Alignof [expr.alignof] (p: 130)

• 17.2.4 尺寸、对齐和偏移 [support.types.layout] (p: 507-508)

• C++17 标准 (ISO/IEC 14882:2017)

• 6.9.2 复合类型 [basic.compound] (p: 81-82)

• 8.3.3 Sizeof [expr.sizeof] (p: 121-122)

• 8.3.6 Alignof [expr.alignof] (p: 129)

• 21.2.4 尺寸、对齐和偏移 [support.types.layout] (p: 479)

• C++14 标准 (ISO/IEC 14882:2014)

• 3.9.2 复合类型 [basic.compound] (p: 73-74)

• 5.3.3 Sizeof [expr.sizeof] (p: 109-110)

• 5.3.6 Alignof [expr.alignof] (p: 116)

• 18.2 类型 [support.types] (p: 443-444)

• C++11 标准 (ISO/IEC 14882:2011)

• 5.3.3 Sizeof [expr.sizeof] (p: 111)

• 5.3.6 Alignof [expr.alignof] (p: 116)

• 18.2 类型 [support.types] (p: 454-455)

• C++03 标准 (ISO/IEC 14882:2003)

• 5.3.3 Sizeof [expr.sizeof] (p: 79)

• C++98 标准 (ISO/IEC 14882:1998)

• 5.3.3 Sizeof [expr.sizeof] (p: 77)

参见

ptrdiff_t	当减去两个指针时返回的有符号整数类型 (typedef)
offsetof	从 标准布局类型的开头到指定成员的字节偏移量 (函数宏)
整数字面量	二进制，(自 C++14 起) 十进制、八进制或十六进制的整数类型数字
C 文档 关于 size_t