Partager via


multiset::begin

Retourne un itérateur traitant le premier élément du multiset.

const_iterator begin( ) const; 
iterator begin( );

Valeur de retour

Un itérateur bidirectionnel s'adressant au premier élément dans le multiset ou l'emplacement avec un multiset vide.

Remarque

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

Exemple

// multiset_begin.cpp
// compile with: /EHsc
#include <set>
#include <iostream>

int main( )
{
   using namespace std;   
   multiset <int> ms1;
   multiset <int>::iterator ms1_Iter;
   multiset <int>::const_iterator ms1_cIter;
   
   ms1.insert( 1 );
   ms1.insert( 2 );
   ms1.insert( 3 );

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

   ms1_Iter = ms1.begin( );
   ms1.erase( ms1_Iter );

   // The following 2 lines would err as the iterator is const
   // ms1_cIter = ms1.begin( );
   // ms1.erase( ms1_cIter );

   ms1_cIter = ms1.begin( );
   cout << "The first element of ms1 is now " << *ms1_cIter << endl;
}
  

Configuration requise

En-tête: <jeu>

Espace de noms : std

Voir aussi

Référence

multiset, classe

Bibliothèque STL (Standard Template Library)