ptrdiff_t

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

类型支持

size_t

ptrdiff_t

nullptr_t (C23)

NULL

max_align_t (C11)

offsetof

数值极限

定宽整数类型 (C99)

 

在标头 <stddef.h> 定义
typedef /* 由实现定义 */ ptrdiff_t;

ptrdiff_t 是二个指针相减结果所拥有的有符号整数类型。

ptrdiff_t 的位宽不小于 17。	(C99 起) (C23 前)
ptrdiff_t 的位宽不小于 16。	(C23 起)

注解

若可能出现负值，则使用 ptrdiff_t 进行指针算术和数组索引。使用其他类型（如 int）的程序，可能会在譬如在 64 位系统上，当下标超过 INT_MAX 时，或若依赖 32 位模算术时失败。

只有指向同一数组中的元素（包括指向数组尾后一个位置）的指针可以相减。

若数组足够大（大于 PTRDIFF_MAX 个元素，但等于或小于 SIZE_MAX 个字节），则两个指针间的距离可能无法以 ptrdiff_t 表示，这两个指针相减的结果未定义。

对于短于 PTRDIFF_MAX 的 char 数组，ptrdiff_t 表现为 size_t 的有符号对应类型：它能存储任何类型的数组大小，而且在大多数平台上是 intptr_t 的同义词。

可能的实现

typedef typeof((int*)nullptr - (int*)nullptr) ptrdiff_t; // C23 起合法

示例

运行此代码

#include <stddef.h>
#include <stdint.h>
#include <stdio.h>
 
int main(void)
{
    const size_t N = 100;
    int numbers[N];
 
    printf("PTRDIFF_MAX = %ld\n", PTRDIFF_MAX);
    int *p1 = &numbers[18], *p2 = &numbers[23];
    ptrdiff_t diff = p2 - p1;
    printf("p2-p1 = %td\n", diff);
}

可能的输出：

PTRDIFF_MAX = 9223372036854775807
p2-p1 = 5

引用

• C23 标准（ISO/IEC 9899:2024）：

• 7.19 Common definitions <stddef.h> （第 TBD 页）

• 7.20.3 Limits of other integer types （第 TBD 页）

• C17 标准（ISO/IEC 9899:2018）：

• 7.19 Common definitions <stddef.h> （第 211 页）

• 7.20.3 Limits of other integer types （第 215 页）

• C11 标准（ISO/IEC 9899:2011）：

• 7.19 Common definitions <stddef.h> （第 288 页）

• 7.20.3 Limits of other integer types （第 293 页）

• C99 标准（ISO/IEC 9899:1999）：

• 7.17 Common definitions <stddef.h> （第 253 页）

• 7.18.3 Limits of other integer types （第 258 页）

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.1.6 Common definitions <stddef.h>

参阅

size_t	sizeof 运算符返回的无符号整数类型 (typedef)
offsetof	从结构体类型的起始到指定成员的字节偏移 (宏函数)