Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::reverse_iterator::base — iterator bazowy

std::reverse_iterator::base zwraca kopię przechowywanego iteratora bazowego. Jego pozycja leży o jeden element dalej w kierunku zwykłej iteracji niż element dostępny przez iterator odwrotny.

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

Składnia

constexpr Iterator base() const;

std::reverse_iterator::base z nagłówka <iterator> zwraca przechowywany iterator current przez wartość, jako typ Iterator. Nie przesuwa iteratora odwrotnego. Wynikiem jest iterator, a nie wartość elementu ani referencja do wewnętrznego iteratora.

Dla dereferencjonowalnego r wyrażenie *r działa jak Iterator tmp = r.base(); return *--tmp;. Zatem r.base() znajduje się o jedną pozycję dalej w kierunku zwykłej iteracji. Aby uzyskać zwykły iterator do tego samego elementu, skopiuj r.base() i zmniejsz kopię.

Na granicach kontenera rbegin().base() == end() oraz rend().base() == begin(). Nie dereferencjonuj end() ani rend(); nie zmniejszaj też begin(). Samo wywołanie base() nie dereferencjonuje wyniku. W przykładzie początkowa baza to pozycja za tablicą; po ++r iterator odwrotny udostępnia 20, a jego baza wskazuje 30.

Przykłady

#include <iostream>
#include <iterator>

int main() {
    int values[] = {10, 20, 30};
    std::reverse_iterator<int*> r(values + 3);

    std::cout << std::boolalpha
              << (r.base() == values + 3) << '\n';
    std::cout << *r << '\n';

    ++r;
    std::cout << *r << ' ' << *r.base() << '\n';

    auto forward = r.base();
    --forward;
    std::cout << *forward << '\n';
}

Wynik

true
30
20 30
20

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

Źródła