Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::ptrdiff_t — typ różnicy wskaźników

std::ptrdiff_t to zdefiniowany przez implementację typ całkowity ze znakiem z nagłówka <cstddef>. Jest typem wyniku odejmowania wskaźników; opisuje odległość w elementach, nie w bajtach, i może przechowywać wartości ujemne.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

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

std::ptrdiff_t, dostępny po dołączeniu <cstddef>, jest aliasem typu całkowitego ze znakiem wybranego przez implementację. Nie zakładaj, że jest to int lub long ani że ma określoną szerokość. Wbudowane odejmowanie wskaźników daje wynik tego typu.

Dla wskaźników na elementy tej samej tablicy last - first oznacza różnicę indeksów, a nie liczbę bajtów. Można uwzględnić wskaźnik tuż za końcem tablicy, ale nie wolno go dereferencjonować. Odwrócenie kolejności operandów odwraca znak wyniku.

Odejmowanie wskaźników do odrębnych tablic powoduje niezdefiniowane zachowanie, nawet gdy ich adresy są blisko siebie. Również różnica niemieszcząca się w std::ptrdiff_t powoduje niezdefiniowane zachowanie. Zapisanie wyniku w szerszym typie nie naprawia samego odejmowania.

W odróżnieniu od tego typu std::size_t jest typem bez znaku używanym między innymi do rozmiarów obiektów w bajtach. Nie używaj go do przechowywania potencjalnie ujemnej różnicy.

W przykładzie last wskazuje tuż za końcem czteroelementowej tablicy, więc last - first ma wartość 4, a first - last ma wartość -4. W testowanym środowisku program wypisuje te wartości jako liczby dziesiętne. Na implementacji z dostatecznie szerokimi bajtami std::ptrdiff_t może jednak być aliasem signed char. W takim przypadku bezpośrednie przekazanie tych wartości do std::cout za pomocą operatora << wypisuje znaki, a nie liczby dziesiętne.

Przykłady

#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';
}

Wynik

4
-4

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła