Spec-Zone.ru › C

ptrdiff_t

Определено в заголовочном файле <stddef.h>
typedef /*implementation-defined*/ 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, то результат вычитания таких указателей является неопределённым.

Для массивов char короче PTRDIFF_MAX, ptrdiff_t выступает как знаковое соответствие size_t: он может хранить размер массива любого типа и на большинстве платформ эквивалентен intptr_t.

Пример

#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

Ссылки

  • Стандарт 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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/types/ptrdiff_t

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API