Compartilhar via


hash_map::rend

ObservaçãoObservação

este API é obsoleto.Uma alternativa é unordered_map Class.

Retorna um iterador atende o local que é bem-sucedido o último elemento em um hash_map invertido.

const_reverse_iterator rend( ) const; 
reverse_iterator rend( );

Valor de retorno

Um iterador bidirecional invertido atende o local que é bem-sucedido o último elemento em um hash_map invertida (o local que tenha precedido o primeiro elemento no hash_map unreversed).

Comentários

rend é usado com um hash_map inverso da mesma forma que end é usado com um hash_map.

Se o valor de retorno de rend é atribuído a const_reverse_iterator, o objeto de hash_map não pode ser alterado.Se o valor de retorno de rend é atribuído a reverse_iterator, o objeto de hash_map pode ser alterado.

rend pode ser usado para testar a se um iterador invertido atingiu o final do seu hash_map.

o valor retornado por rend não deve ser desreferenciado.

Em o Visual C++ .NET 2003, os membros dos arquivos de cabeçalho de <hash_map> e de <hash_set> não estão mais no namespace de STD, mas tenham sido portados em vez de stdext no namespace.Consulte O namespace de stdext para mais informações.

Exemplo

// hash_map_rend.cpp
// compile with: /EHsc
#include <hash_map>
#include <iostream>

int main( )
{
   using namespace std;
   using namespace stdext;
   hash_map <int, int> hm1;

   hash_map <int, int> :: iterator hm1_Iter;
   hash_map <int, int> :: reverse_iterator hm1_rIter;
   hash_map <int, int> :: const_reverse_iterator hm1_crIter;
   typedef pair <int, int> Int_Pair;

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

   hm1_rIter = hm1.rend( );
   hm1_rIter--;
   cout << "The last element of the reversed hash_map hm1 is "
        << hm1_rIter -> first << "." << endl;

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

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

   // A hash_map element can be erased by dereferencing to its key 
   hm1_rIter = --hm1.rend( );
   hm1.erase ( hm1_rIter -> first );

   hm1_rIter = hm1.rend( );
   hm1_rIter--;
   cout << "After the erasure, the last element "
        << "in the reversed hash_map is "
        << hm1_rIter -> first << "." << endl;
}
  
  
  
  

Requisitos

Cabeçalho: <hash_map>

stdext denamespace:

Consulte também

Referência

hash_map Class

Standard Template Library