WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::reverse_iterator::base — der zugrunde liegende Iterator

std::reverse_iterator::base gibt eine Kopie des gespeicherten zugrunde liegenden Iterators zurück. Seine Position liegt in Richtung der normalen Iteration ein Element hinter dem Element, auf das über den Reverse-Iterator zugegriffen wird.

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

Syntax

constexpr Iterator base() const;

std::reverse_iterator::base aus dem Header <iterator> gibt den gespeicherten Iterator current als Wert vom Typ Iterator zurück. Der Reverse-Iterator wird dadurch nicht weiterbewegt. Das Ergebnis ist ein Iterator, kein Elementwert und keine Referenz auf den internen Iterator.

Für ein dereferenzierbares r verhält sich *r wie Iterator tmp = r.base(); return *--tmp;. Daher liegt r.base() in Richtung der normalen Iteration eine Position weiter. Um einen normalen Iterator auf dasselbe Element zu erhalten, kopiere r.base() und dekrementiere die Kopie.

An den Grenzen eines Containers gilt rbegin().base() == end() und rend().base() == begin(). Dereferenziere weder end() noch rend() und dekrementiere auch begin() nicht. Der Aufruf von base() selbst dereferenziert das Ergebnis nicht. Im Beispiel zeigt die anfängliche Basisposition hinter das Array; nach ++r greift der Reverse-Iterator auf 20 zu, während seine Basis auf 30 zeigt.

Beispiele

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

Ergebnis

true
30
20 30
20

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen