hash_multiset::rend

Nota
Esta API está obsoleta.La alternativa es unordered_multiset (Clase).

Devuelve un iterador que dirige la ubicación que funciona correctamente el último elemento en un hash_multiset invertido.

const_reverse_iterator rend( ) const; 
reverse_iterator rend( );

Valor devuelto

Un iterador bidireccional inversa que dirige la ubicación que funciona correctamente el último elemento en un hash_multiset invertido (la ubicación que había precedido el primer elemento del hash_multiset unreversed).

Comentarios

rend se utiliza con un hash_multiset invertido igual que final se utiliza con un hash_multiset.

Si el valor devuelto de rend se asigna a const_reverse_iterator, el objeto de hash_multiset no puede modificarse. Si el valor devuelto de rend se asigna a reverse_iterator, el objeto de hash_multiset puede modificarse. El valor devuelto por rend no se debe desreferenciar.

rend se puede utilizar para probar a si un iterador inverso ha llegado al final del hash_multiset.

En Visual C++ .NET 2003, los miembros de los archivos de encabezado <hash_map> y <hash_set> ya no están en el espacio de nombres std, sino que se han movido al espacio de nombres stdext. Vea El espacio de nombres stdext para obtener más información.

Ejemplo

// hash_multiset_rend.cpp
// compile with: /EHsc
#include <hash_set>
#include <iostream>

int main( )
{
   using namespace std;
   using namespace stdext;
   hash_multiset <int> hms1;
   hash_multiset <int>::iterator hms1_Iter;
   hash_multiset <int>::reverse_iterator hms1_rIter;
   hash_multiset <int>::const_reverse_iterator hms1_crIter;

   hms1.insert( 10 );
   hms1.insert( 20 );
   hms1.insert( 30 );

   hms1_rIter = hms1.rend( );
   hms1_rIter--;
   cout << "The last element in the reversed hash_multiset is "
        << *hms1_rIter << "." << endl;

   // end can be used to terminate an iteration 
   // through a hash_multiset in a forward order
   cout << "The hash_multiset is: ";
   for ( hms1_Iter = hms1.begin( ) ; hms1_Iter != hms1.end( );
         hms1_Iter++ )
      cout << *hms1_Iter << " ";
   cout << "." << endl;

   // rend can be used to terminate an iteration 
   // throught a hash_multiset in a reverse order
   cout << "The reversed hash_multiset is: ";
   for ( hms1_rIter = hms1.rbegin( ) ; hms1_rIter != hms1.rend( );
         hms1_rIter++ )
      cout << *hms1_rIter << " ";
   cout << "." << endl;

   hms1_rIter = hms1.rend( );
   hms1_rIter--;
   hms1.erase ( *hms1_rIter );

   hms1_rIter = hms1.rend( );
   hms1_rIter--;
   cout << "After the erasure, the last element in the "
        << "reversed hash_multiset is " << *hms1_rIter << "."
        << endl;
}

Requisitos

Encabezado: <hash_set>

Espacio de nombres: stdext

Vea también

Referencia

hash_multiset (Clase)

Biblioteca de plantillas estándar