Partager via


list::begin

Retourne un itérateur qui traite le premier élément d'une liste.

const_iterator begin( ) const; iterator begin( );

Valeur de retour

Itérateur bidirectionnel qui traite le premier élément dans la liste ou à l'emplacement qui suit une liste vide.

Notes

Si la valeur de retour de begin est affectée à const_iterator, les éléments de l'objet de liste ne peuvent pas être changés. Si la valeur de retour de begin est affectée à iterator, les éléments de l'objet de liste peuvent être changés.

Exemple

// list_begin.cpp
// compile with: /EHsc
#include <list>
#include <iostream>

int main( ) 
{
   using namespace std;
   list <int> c1;
   list <int>::iterator c1_Iter;
   list <int>::const_iterator c1_cIter;
   
   c1.push_back( 1 );
   c1.push_back( 2 );

   c1_Iter = c1.begin( );
   cout << "The first element of c1 is " << *c1_Iter << endl;

   *c1_Iter = 20;
   c1_Iter = c1.begin( );
   cout << "The first element of c1 is now " << *c1_Iter << endl;

   // The following line would be an error because iterator is const
   // *c1_cIter = 200;
}
  

Configuration requise

En-tête : <list>

Espace de noms : std

Voir aussi

Référence

list, classe

Bibliothèque STL (Standard Template Library)