Partager via


multimap::begin

Retourne un itérateur adressage le premier élément dans le mappage multiples.

const_iterator begin( ) const; 
iterator begin( );

Valeur de retour

Un itérateur bidirectionnelle adressage le premier élément dans le mappage multiples ou l'emplacement réussissant un mappage plusieurs vide.

Remarque

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

Exemple

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

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

   multimap <int, int> :: iterator m1_Iter;
   multimap <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 as the iterator is const
   // m1_cIter = m1.begin ( );
   // m1.erase ( m1_cIter );

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

Configuration requise

En-tête : <mappage>

Espace de noms : std

Voir aussi

Référence

multimap, classe

Bibliothèque STL (Standard Template Library)