Freigeben über


list::begin

Gibt einen Iterator zurück, der das erste Element in einer Liste adressiert.

const_iterator begin( ) const; iterator begin( );

Rückgabewert

Ein bidirektionaler Iterator, der das erste Element in der Liste adressiert oder auf den Speicherort hinweist, der auf eine leere Liste folgt.

Hinweise

Wenn der Rückgabewert von Beginn einem const_iterator zugewiesen wird, kann das Listenobjekt nicht geändert werden. Wenn der Rückgabewert von Beginn einem Iterator zugewiesen wird, können die Elemente in der Liste geändert werden.

Beispiel

// 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;
}
  

Anforderungen

Header: <list>

Namespace: std

Siehe auch

Referenz

list-Klasse

Standardvorlagenbibliothek