size_t

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

类型支持

size_t

ptrdiff_t

nullptr_t (C23)

NULL

max_align_t (C11)

offsetof

数值极限

定宽整型 (C99 起)

 

定义于头文件 <stddef.h>
定义于头文件 <stdio.h>
在头文件 <stdlib.h> 中定义
定义于头文件 <string.h>
定义于头文件 <time.h>
在头文件 <uchar.h> 中定义		(C11 起)
在头文件 <wchar.h> 中定义		(自 C95 起)
typedef /*实现定义*/ size_t;

size_t 是 sizeof、offsetof 和 _Alignof(C23 前)alignof(C23 起) 的结果的无符号整型，具体取决于数据模型。

size_t 的位宽不小于 16。

(C99 起)

注意

size_t 可以存储任何类型（包括数组）的理论上可能的最大对象大小。

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

可能的实现

typedef typeof(sizeof(0)) size_t; // valid since C23

示例

运行此代码

#include <stddef.h>
#include <stdint.h>
#include <stdio.h>
 
int main(void)
{
    const size_t N = 101;
    int numbers[N];
    size_t sum = 0;
    for (size_t ndx = 0; ndx < N; ++ndx)
        sum += numbers[ndx] = ndx;
    size_t size = sizeof numbers;
    printf("sum = %zu\n", sum);
    printf("size = %zu\n", size);
    printf("SIZE_MAX = %zu\n", SIZE_MAX);
}

可能的输出

sum = 5050
size = 404
SIZE_MAX = 18446744073709551615

参考

• C23 标准 (ISO/IEC 9899:2024)

• 7.19 常见定义 <stddef.h> (p: TBD)

• 7.20.3 其他整数类型的限制 (p: 待定)

• C17 标准 (ISO/IEC 9899:2018)

• 7.19 常用定义 <stddef.h> (p: 211)

• 7.20.3 其他整数类型的限制 (p: 215)

• C11 标准 (ISO/IEC 9899:2011)

• 7.19 常见定义 <stddef.h> (p: 288)

• 7.20.3 其他整数类型的限制 (p: 293)

• C99 标准 (ISO/IEC 9899:1999)

• 7.17 常用定义 <stddef.h> (p: 253)

• 7.18.3 其他整数类型的限制 (p: 258)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.1.6 常用定义 <stddef.h>

另请参阅

ptrdiff_t	减去两个指针时返回的有符号整型 (typedef)
offsetof	从结构体类型开头到指定成员的字节偏移量 (函数宏)
C++ documentation for size_t