ptrdiff_t

ptrdiff_t は、2つのポインタの 減算結果 の符号付き整数型です。

注記

ptrdiff_t は、負の値が可能性がある場合のポインタ演算および配列のインデックス指定に使用されます。 int などの他の型を使用するプログラムは、例えば64ビットシステムでインデックスが INT_MAX を超える場合、または32ビットのモジュラー演算に依存している場合に失敗する可能性があります。

同じ配列の要素へのポインタ（配列の終端を1つ超えた位置へのポインタも含む）のみが互いに減算できます。

配列が非常に大きく（ PTRDIFF_MAX 要素を超え、かつ SIZE_MAX バイト以下）、2つのポインタの差が ptrdiff_t として表現できない場合、そのような2つのポインタを減算した結果は未定義です。

PTRDIFF_MAXより短いchar配列の場合、 ptrdiff_t は PTRDIFF_MAX の符号付き対応物として機能します： 任意の型の配列のサイズを格納でき、ほとんどのプラットフォームでは 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

参考文献

関連項目