ptrdiff_t

typedef /*implementation-defined*/ ptrdiff_t;

ptrdiff_t — знаковый целочисленный тип результата вычитания двух указателей.

Примечания

ptrdiff_t используется для арифметики указателей и индексации массивов, если возможны отрицательные значения. Программы, в которых используются другие типы, например int, могут работать некорректно, например, в 64-разрядных системах, если индекс превышает INT_MAX или если программа полагается на 32-разрядную модульную арифметику.

Вычитать друг из друга можно только указатели на элементы одного и того же массива (включая указатель на элемент за последним элементом массива).

Если массив настолько велик (более PTRDIFF_MAX элементов, но не более SIZE_MAX байт), что разность двух указателей может быть непредставима в виде ptrdiff_t, результат вычитания таких указателей не определён.

Для массивов char размером менее 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> (стр.: TBD)
• 7.20.3 Пределы значений других целочисленных типов (стр.: TBD)
• Стандарт 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>

См. также