Partager via


multimap::rbegin

Retourne un itérateur s'adressant au premier élément d'une multimap inversée.

const_reverse_iterator rbegin( ) const; 
reverse_iterator rbegin( );

Valeur de retour

Un itérateur bidirectionnel inverse adressant le premier élément d'une multimap inversée ou adressant ce qui avait été le dernier élément de la multimap non inversée.

Notes

rbegin est utilisé avec une multimap inversée tout comme début est utilisé avec une multimap.

Si la valeur de retour de rbegin est assignée à const_reverse_iterator, il est alors impossible de modifier l'objet multimap. Si la valeur de retour de rbegin est affectée à reverse_iterator,il est alors possible de modifier l'objet multimap.

rbegin peut être utilisé pour itérer en arrière au sein d'une multimap.

Exemple

// multimap_rbegin.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> :: reverse_iterator m1_rIter;
   multimap <int, int> :: const_reverse_iterator m1_crIter;
   typedef pair <int, int> Int_Pair;

   m1.insert ( Int_Pair ( 1, 10 ) );
   m1.insert ( Int_Pair ( 2, 20 ) );
   m1.insert ( Int_Pair ( 3, 30 ) );

   m1_rIter = m1.rbegin( );
   cout << "The first element of the reversed multimap m1 is "
        << m1_rIter -> first << "." << endl;

   // begin can be used to start an iteration 
   // throught a multimap in a forward order
   cout << "The multimap is: ";
   for ( m1_Iter = m1.begin( ) ; m1_Iter != m1.end( ); m1_Iter++)
      cout << m1_Iter -> first << " ";
      cout << "." << endl;

   // rbegin can be used to start an iteration 
   // throught a multimap in a reverse order
   cout << "The reversed multimap is: ";
   for ( m1_rIter = m1.rbegin( ) ; m1_rIter != m1.rend( ); m1_rIter++)
      cout << m1_rIter -> first << " ";
      cout << "." << endl;

   // A multimap element can be erased by dereferencing its key 
   m1_rIter = m1.rbegin( );
   m1.erase ( m1_rIter -> first );

   m1_rIter = m1.rbegin( );
   cout << "After the erasure, the first element "
        << "in the reversed multimap is "
        << m1_rIter -> 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)