Freigeben über


map::begin

Gibt ein Iterator zurück, der das erste Element in der Zuordnung.

const_iterator begin( ) const; 
iterator begin( );

Rückgabewert

Ein bidirektionalem Iterator, welche das erste Element in der Zuordnung oder Position folgen einer leeren Zuordnung behandelt.

Hinweis

Wenn const_iterator der Rückgabewert von begin zugewiesen wird, können die Elemente im Zuordnungsobjekt nicht geändert werden. Wenn Iterator der Rückgabewert von begin zugewiesen wird, können die Elemente im Zuordnungsobjekt geändert werden.

Beispiel

// map_begin.cpp
// compile with: /EHsc
#include <map>
#include <iostream>

int main( )
{
   using namespace std;
   map <int, int> m1;

   map <int, int> :: iterator m1_Iter;
   map <int, int> :: const_iterator m1_cIter;
   typedef pair <int, int> Int_Pair;

   m1.insert ( Int_Pair ( 0, 0 ) );
   m1.insert ( Int_Pair ( 1, 1 ) );
   m1.insert ( Int_Pair ( 2, 4 ) );

   m1_cIter = m1.begin ( );
   cout << "The first element of m1 is " << m1_cIter -> first << endl;
   
   m1_Iter = m1.begin ( );
   m1.erase ( m1_Iter );

   // The following 2 lines would err because the iterator is const
   // m1_cIter = m1.begin ( );
   // m1.erase ( m1_cIter );

   m1_cIter = m1.begin( );
   cout << "The first element of m1 is now " << m1_cIter -> first << endl;
}
  

Anforderungen

Header: <map>

Namespace: std

Siehe auch

Referenz

map-Klasse

Standardvorlagenbibliothek