命名空间
变体
操作

ptrdiff_t

来自 cppreference.cn
< c‎ | 类型
定义于头文件 <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; // 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> (p: TBD)
  • 7.20.3 其他整数类型的限制 (p: TBD)
  • 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>

[编辑] 另请参阅

sizeof 运算符返回的无符号整型
(typedef) [编辑]
从结构体类型开头到指定成员的字节偏移量
(函数宏) [编辑]
C++ 文档 关于 ptrdiff_t