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.