命名空间
变体
操作

std::size_t

来自 cppreference.com
< cpp‎ | types
 
 
实用程序库
语言支持
类型支持 (基本类型,RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三方比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
类型支持
基本类型
定长整数类型 (C++11)
定长浮点数类型 (C++23)
size_t
(C++11)    
(C++17)
数值限制
C 数值限制接口
运行时类型信息
 
定义在头文件 <cstddef>
定义在头文件 <cstdio>
定义在头文件 <cstdlib>
定义在头文件 <cstring>
定义在头文件 <ctime>
定义在头文件 <cuchar>
(自 C++17 起)
定义在头文件 <cwchar>
typedef /*implementation-defined*/ size_t;

std::size_tsizeof 运算符以及 sizeof... 运算符和 alignof 运算符(自 C++11 起)的结果的无符号整型。

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

(自 C++11 起)

内容

[编辑] 注释

std::size_t 可以存储任何类型(包括数组)的理论上可能的最大对象的大小。如果类型的 size 不能由 std::size_t 表示,则该类型是非法的。在许多平台上(具有分段寻址的系统除外)std::size_t 可以安全地存储任何非成员指针的值,在这种情况下,它与 std::uintptr_t 同义。

std::size_t 通常用于数组索引和循环计数。使用其他类型(如 unsigned int)进行数组索引的程序可能会在例如 64 位系统上失败,因为索引超过了 UINT_MAX 或依赖于 32 位模运算。

在索引 C++ 容器(如 std::stringstd::vector 等)时,适当的类型是这些容器提供的成员 typedef size_type。它通常定义为 std::size_t 的同义词。

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

std::size_t整数字面量后缀zZuU 的任何组合(即 zuzUZuZUuzuZUzUZ)。

(自 C++23 起)

[编辑] 可能的实现

using size_t = decltype(sizeof(0)); // valid since C++11

[编辑] 示例

#include <array>
#include <cstddef>
#include <iostream>
 
int main()
{
    std::array<std::size_t, 10> a;
 
    // Example with C++23 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++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)

[编辑] 另请参阅

减去两个指针时返回的有符号整型
(typedef) [编辑]
标准布局 类型开始到指定成员的字节偏移量
(函数宏) [编辑]
整数字面量 二进制,(自 C++14 起)十进制、八进制或十六进制的整数类型数字[编辑]
C 文档 对于 size_t