Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::reverse_iterator::base — l’itérateur sous-jacent

std::reverse_iterator::base renvoie une copie de l’itérateur sous-jacent stocké. Sa position se trouve un élément plus loin dans le sens de l’itération normale que l’élément accessible via l’itérateur inverse.

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

Syntaxe

constexpr Iterator base() const;

std::reverse_iterator::base, déclaré dans l’en-tête <iterator>, renvoie par valeur l’itérateur stocké current, de type Iterator. Il ne fait pas avancer l’itérateur inverse. Le résultat est un itérateur, et non une valeur d’élément ni une référence à l’itérateur interne.

Pour un r déréférençable, *r se comporte comme Iterator tmp = r.base(); return *--tmp;. Ainsi, r.base() se trouve une position plus loin dans le sens de l’itération normale. Pour obtenir un itérateur normal vers le même élément, copiez r.base() et décrémentez la copie.

Aux limites d’un conteneur, rbegin().base() == end() et rend().base() == begin(). Ne déréférencez ni end() ni rend(), et ne décrémentez pas begin(). L’appel de base() ne déréférence pas lui-même le résultat. Dans l’exemple, la base initiale se trouve après le tableau ; après ++r, l’itérateur inverse accède à 20, tandis que sa base pointe sur 30.

Exemples

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

Résultat

true
30
20 30
20

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources