CKTIS / C++
std::reverse_iterator::base — o iterador subjacente
std::reverse_iterator::base devolve uma cópia do iterador subjacente armazenado. A sua posição fica um elemento mais à frente no sentido da iteração normal do que o elemento acessível através do iterador inverso.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
constexpr Iterator base() const;std::reverse_iterator::base, declarado no cabeçalho <iterator>, devolve por valor o iterador armazenado current, do tipo Iterator. Não faz avançar o iterador inverso. O resultado é um iterador, não o valor de um elemento nem uma referência ao iterador interno.
Para um r desreferenciável, *r comporta-se como Iterator tmp = r.base(); return *--tmp;. Assim, r.base() fica uma posição mais à frente no sentido da iteração normal. Para obter um iterador normal para o mesmo elemento, copia r.base() e decrementa a cópia.
Nos limites de um contentor, rbegin().base() == end() e rend().base() == begin(). Não desreferencies end() nem rend(), e não decrementes begin(). A chamada a base() não desreferencia, por si só, o resultado. No exemplo, a base inicial está depois do array; após ++r, o iterador inverso acede a 20, enquanto a sua base aponta para 30.
Exemplos
#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';
}
Resultado
true 30 20 30 20
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.