CKTIS / C++
std::advance : déplacer un itérateur d’une distance
std::advance modifie un itérateur passé par référence de n positions. Elle ne contrôle pas les limites et renvoie void.
Version : C++23
Syntaxe
template<class InputIt, class Distance>
constexpr void advance(InputIt& it, Distance n);std::advance de <iterator> modifie it comme après n pas. L’accès aléatoire permet it += n en temps constant ; les catégories plus faibles répètent les incréments, et un itérateur bidirectionnel décrémente pour un n négatif.
Utilise-la lorsque l’objet itérateur doit changer. Pour conserver l’original, std::next renvoie plus clairement un nouvel itérateur. La complexité est linéaire hors accès aléatoire.
La fonction ignore les bornes du conteneur. Aller avant le début ou au-delà du end() valide est indéfini. Une distance négative exige un itérateur bidirectionnel. Après une modification du conteneur, vérifie aussi sa validité.
Exemples
#include <array>
#include <iostream>
#include <iterator>
int main() {
const std::array values{2, 5, 9};
auto iterator = values.begin();
std::advance(iterator, 2);
std::cout << *iterator << '\n';
}
Résultat
9
std::advance → 9