deque::rbegin

Article
06/09/2015

Retourne un itérateur au premier élément d'un deque inversé.

const_reverse_iterator rbegin( ) const; 
reverse_iterator rbegin( );

Valeur de retour

Un itérateur d'accès aléatoire inversé qui adresse le premier élément d'un deque inversé ou adresse celui qui avait été le dernier élement du deque non inversé.

Notes

rbegin est utilisé avec un deque inversé comme commencer est utilisé avec un deque.

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

rbegin peut être utilisé pour itérer en arrière au sein d'un deque.

Exemple

// deque_rbegin.cpp
// compile with: /EHsc
#include <deque>
#include <iostream>

int main( ) 
{
   using namespace std;
   deque <int> c1;
   deque <int>::iterator c1_Iter;
   deque <int>::reverse_iterator c1_rIter;

   // If the following line had replaced the line above, an error 
   // would have resulted in the line modifying an element 
   // (commented below) because the iterator would have been const
   // deque <int>::const_reverse_iterator c1_rIter;
   
   c1.push_back( 10 );
   c1.push_back( 20 );
   c1.push_back( 30 );

   c1_rIter = c1.rbegin( );
   cout << "Last element in the deque is " << *c1_rIter << "." << endl;

   cout << "The deque contains the elements: ";
   for ( c1_Iter = c1.begin( ); c1_Iter != c1.end( ); c1_Iter++ )
      cout << *c1_Iter << " ";
   cout << "in that order.";
   cout << endl;

   // rbegin can be used to iterate through a deque in reverse order
   cout << "The reversed deque is: ";
   for ( c1_rIter = c1.rbegin( ); c1_rIter != c1.rend( ); c1_rIter++ )
      cout << *c1_rIter << " ";
   cout << endl;

   c1_rIter = c1.rbegin( );
   *c1_rIter = 40;  // This would have caused an error if a 
                    // const_reverse iterator had been declared as 
                    // noted above
   cout << "Last element in deque is now " << *c1_rIter << "." << endl;
}