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; // 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>

另請參閱

size_t	由 sizeof 運算子返回的無符號整型 (typedef)
offsetof	從結構體型別開頭到指定成員的位元組偏移量 (函式宏)
C++ 文件 關於 ptrdiff_t