Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes