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 的字符数组，ptrdiff_t 充当 size_t 的有符号对应物：它可以存储任何类型的数组的大小，并且在大多数平台上，与 intptr_t 同义）。

可能的实现

typedef typeof((int*)nullptr - (int*)nullptr) ptrdiff_t; // valid since 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 通用定义 <stddef.h> (页码: 待定)

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

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

• 7.19 通用定义 <stddef.h> (页码: 211)

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

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

• 7.19 通用定义 <stddef.h> (页码: 288)

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

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

• 7.17 通用定义 <stddef.h> (页码: 253)

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

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

• 4.1.6 通用定义 <stddef.h>

参见

size_t	sizeof 运算符返回的无符号整数类型 (typedef)
offsetof	从结构体类型起始位置到指定成员的字节偏移量 (函数宏)
C++ 文档 关于 ptrdiff_t