multimap::begin
Retourne un itérateur adressant le premier élément dans le mappage multiple.
const_iterator begin( ) const;
iterator begin( );
Valeur de retour
Un itérateur bidirectionnel adressant le premier élément dans le mappage multiple ou l'emplacement réussissant un mappage multiple vide.
Note
Si la valeur de retour de begin est assignée à const_iterator, les éléments de l'objet de mappage multiple ne peuvent pas être modifiés.Si la valeur de retour de begin est assignée à iterator, les éléments de l'objet de mappage plusieurs 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 : <map>
l'espace de noms : DST