Partager via


set::rend

Retourne un itérateur qui traite l'emplacement suivant le dernier élément d'une classe set inversée.

const_reverse_iterator rend( ) const; 
reverse_iterator rend( );

Valeur de retour

Un itérateur bidirectionnel inversé qui gère l'emplacement succédant au dernier élément d'un jeu inversé (l'emplacement qui avait précédé le premier élément dans le jeu non inversé).

Notes

rend est utilisé avec un set inversé comme end est utilisé avec un set.

Si la valeur de retour de rend est assignée à const_reverse_iterator, il est impossible de modifier l'objet de set. Si la valeur de retour de rend est assignée à reverse_iterator, il est possible de modifier l'objet de set. La valeur retournée par rend ne doit pas être déréférencée.

Il est possible d'utiliser rend pour tester si un itérateur inverse a atteint la fin de son jeu.

Exemple

// set_rend.cpp
// compile with: /EHsc
#include <set>
#include <iostream>

int main() {
   using namespace std;   
   set <int> s1;
   set <int>::iterator s1_Iter;
   set <int>::reverse_iterator s1_rIter;
   set <int>::const_reverse_iterator s1_crIter;

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

   s1_rIter = s1.rend( );
   s1_rIter--;
   cout << "The last element in the reversed set is "
        << *s1_rIter << "." << endl;

   // end can be used to terminate an iteration 
   // throught a set in a forward order
   cout << "The set is: ";
   for ( s1_Iter = s1.begin( ) ; s1_Iter != s1.end( ); s1_Iter++ )
      cout << *s1_Iter << " ";
   cout << "." << endl;

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

   s1_rIter = s1.rend( );
   s1_rIter--;
   s1.erase ( *s1_rIter );

   s1_rIter = s1.rend( );
   --s1_rIter;
   cout << "After the erasure, the last element in the "
        << "reversed set is " << *s1_rIter << "." << endl;
}

Sortie

The last element in the reversed set is 10.
The set is: 10 20 30 .
The reversed set is: 30 20 10 .
After the erasure, the last element in the reversed set is 20.

Configuration requise

En-tête: <jeu>

Espace de noms : std

Voir aussi

Référence

set, classe

set::rbegin et set::rend

Bibliothèque STL (Standard Template Library)