multimap::rbegin

Devuelve un iterador que dirige el primer elemento de un multimap invertido.

const_reverse_iterator rbegin( ) const; 
reverse_iterator rbegin( );

Valor devuelto

Un iterador bidireccional inversa que dirige el primer elemento de un multimap o un direccionamiento invertido que había sido el último elemento del multimap unreversed.

Comentarios

rbegin se utiliza con un multimap invertido igual que inicio se utiliza con un multimap.

Si el valor devuelto de rbegin se asigna a const_reverse_iterator, el objeto de multimap no puede modificarse. Si el valor devuelto de rbegin se asigna a reverse_iterator, el objeto de multimap puede modificarse.

rbegin se puede utilizar para iterar por un multimap hacia atrás.

Ejemplo

// 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;
}

Requisitos

Encabezado: <map>

Espacio de nombres: std

Vea también

Referencia

multimap (Clase)

Biblioteca de plantillas estándar