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