Partager via


hash_multiset::rbegin

Notes

Cette API est obsolète.L'alternative est unordered_multiset, classe.

Retourne un itérateur adressant le premier élément dans un hash_multiset inversé.

const_reverse_iterator rbegin( ) const; 
reverse_iterator rbegin( );

Valeur de retour

Un itérateur bidirectionnel inverse adressant le premier élément dans un hash_multiset inversé ou adressant ce qui avait été le dernier élément du hash_multiset non inversé.

Notes

rbegin est utilisé avec un hash_multiset inversé exactement comme begin est utilisé avec un hash_multiset.

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

rbegin peut être utilisé pour itérer à reculons au sein d'un hash_multiset.

Dans Visual C++ .NET 2003, les membres des fichiers d'en-tête <hash_map> et de <hash_set> ne sont plus dans l'espace de noms standard, mais ont été plutôt déplacés dans l'espace de noms de stdext. Pour plus d'informations, consultez The stdext Namespace.

Exemple

// hash_multiset_rbegin.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;

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

   hms1_rIter = hms1.rbegin( );
   cout << "The first element in the reversed hash_multiset is "
        << *hms1_rIter << "." << endl;

   // begin can be used to start an iteration 
   // throught 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;

   // rbegin can be used to start 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;

   // A hash_multiset element can be erased by dereferencing to its key 
   hms1_rIter = hms1.rbegin( );
   hms1.erase ( *hms1_rIter );

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

Configuration requise

Header: <hash_set>

Espace de noms : stdext

Voir aussi

Référence

hash_multiset, classe

Bibliothèque STL (Standard Template Library)