База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::ptrdiff_t — тип за разлика между указатели

std::ptrdiff_t е дефиниран от реализацията знаков целочислен тип от <cstddef>. Той е типът на резултата от изваждане на указатели: представя разстояние в елементи, а не в байтове, и може да съдържа отрицателни стойности.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <cstddef>
std::ptrdiff_t distance = last - first;

std::ptrdiff_t, достъпен след включване на <cstddef>, е псевдоним за знаков целочислен тип, избран от реализацията. Не приемайте, че това е int или long, нито че има фиксирана ширина. Вграденото изваждане на указатели дава резултат от този тип.

За указатели към елементи на един и същ масив last - first означава разликата между индексите им, а не брой байтове. Може да се използва указател непосредствено след края на масива, но той не бива да се разименува. Размяната на операндите обръща знака на резултата.

Изваждането на указатели към различни масиви води до неопределено поведение, дори адресите им да са близки. До неопределено поведение води и разлика, която не може да се представи в диапазона на std::ptrdiff_t. Записването на резултата в по-широк тип не поправя самото изваждане.

За разлика от него, std::size_t е тип без знак и се използва, наред с други неща, за размери на обекти в байтове. Не го използвайте за съхраняване на потенциално отрицателна разлика.

В примера last сочи непосредствено след края на масива от четири елемента, затова last - first има стойност 4, а first - last има стойност -4. В тестваната среда програмата извежда тези стойности като десетични числа. При реализация с достатъчно битове в един байт обаче std::ptrdiff_t може да е псевдоним на signed char. В този случай директното подаване на стойностите към std::cout чрез << извежда знаци вместо десетични числа.

Примери

#include <cstddef>
#include <iostream>

int main() {
    int values[] = {10, 20, 30, 40};
    const int* first = values;
    const int* last = values + 4;

    std::ptrdiff_t forward = last - first;
    std::ptrdiff_t backward = first - last;

    std::cout << forward << '\n' << backward << '\n';
}

Резултат

4
-4

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници