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

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

Sources