Partager via


advance (STL Samples)

Illustre comment utiliser la fonction de bibliothèque de types (STL) Standard d' avance dans Visual C++.

template<class InIt, class Dist>
   void advance(
      InIt& it, 
      Dist n
   );

Notes

[!REMARQUE]

Les noms de classes/paramètre dans le prototype ne correspondent pas à la version du fichier d'en-tête.certains ont été modifiés pour améliorer la lisibilité.

La fonction d' avance STL accepte deux paramètres :

  • InIt - l'itérateur à avancer.

  • Dist - nombre d'éléments pour incrémenter l'itérateur par.

la fonction d' avance STL avance les temps de l'itérateur n .Si l'itérateur est un type des itérateurs d'accès aléatoire, la fonction évalue l'expression comme itérateur += *N.*Sinon, il exécute chaque incrément en évaluant : ++iterator.Si l'itérateur est une entrée ou un type anticipée itérateur, n ne doit pas être négatif.

Exemple

// Advance.cpp
// compile with: /EHsc

#pragma warning (disable:4786)
#include <iostream>
#include <string>
#include <list>

using namespace std ;

typedef list<string> STRLIST;

int main() {
    STRLIST List;
    STRLIST::iterator iList;
    STRLIST::difference_type dTheDiff;

    List.push_back("A1");
    List.push_back("B2");
    List.push_back("C3");
    List.push_back("D4");
    List.push_back("E5");
    List.push_back("F6");
    List.push_back("G7");

    // Print out the list
    iList=List.begin();
    cout << "The list is: ";
    for (int i = 0; i < 7 ; i++, iList++)
        cout << *iList  << "  ";

    // Initialize to the first element"
    iList=List.begin();
    cout << "\n\nAdvance to the 3rd element." << endl;
    advance(iList,2);
    cout << "The element is " << *iList << endl;
    dTheDiff = distance( List.begin(), iList);
}

Sortie

The list is: A1  B2  C3  D4  E5  F6  G7  

Advance to the 3rd element.
The element is C3

Configuration requise

en-tête : <iterator>

Voir aussi

Concepts

Exemples de modèles Standard