Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::reverse_iterator::base — l’iteratore sottostante

std::reverse_iterator::base restituisce una copia dell’iteratore sottostante memorizzato. La sua posizione è un elemento più avanti, nel senso dell’iterazione normale, rispetto all’elemento accessibile tramite l’iteratore inverso.

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

Sintassi

constexpr Iterator base() const;

std::reverse_iterator::base, dichiarato nell’header <iterator>, restituisce per valore l’iteratore memorizzato current, di tipo Iterator. Non fa avanzare l’iteratore inverso. Il risultato è un iteratore, non il valore di un elemento né un riferimento all’iteratore interno.

Per un r dereferenziabile, *r si comporta come Iterator tmp = r.base(); return *--tmp;. Quindi r.base() si trova una posizione più avanti nel senso dell’iterazione normale. Per ottenere un iteratore normale allo stesso elemento, copia r.base() e decrementa la copia.

Ai limiti di un contenitore, rbegin().base() == end() e rend().base() == begin(). Non dereferenziare né end() né rend() e non decrementare begin(). La chiamata a base() non dereferenzia di per sé il risultato. Nell’esempio, la base iniziale si trova dopo l’array; dopo ++r, l’iteratore inverso accede a 20, mentre la sua base punta a 30.

Esempi

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

Risultato

true
30
20 30
20

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti