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.