KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::reverse_iterator::base — de onderliggende iterator

std::reverse_iterator::base retourneert een kopie van de opgeslagen onderliggende iterator. De positie ligt één element verder in de richting van normale iteratie dan het element dat via de reverse-iterator toegankelijk is.

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

Syntax

constexpr Iterator base() const;

std::reverse_iterator::base, gedeclareerd in de header <iterator>, retourneert de opgeslagen iterator current als waarde van het type Iterator. De reverse-iterator wordt hierdoor niet verder verplaatst. Het resultaat is een iterator, geen elementwaarde en geen verwijzing naar de interne iterator.

Voor een dereferentieerbare r gedraagt *r zich als Iterator tmp = r.base(); return *--tmp;. Daarom ligt r.base() één positie verder in de richting van normale iteratie. Kopieer r.base() en verlaag de kopie om een normale iterator naar hetzelfde element te krijgen.

Aan de grenzen van een container geldt rbegin().base() == end() en rend().base() == begin(). Dereferentieer end() of rend() niet en verlaag begin() niet. De aanroep van base() dereferentieert het resultaat zelf niet. In het voorbeeld ligt de aanvankelijke basispositie voorbij de array; na ++r benadert de reverse-iterator 20, terwijl de basis naar 30 wijst.

Voorbeelden

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

Resultaat

true
30
20 30
20

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen