C++ Standard Library C++ STL Library

C++ <list> - crbegin() Function



The C++ list::crbegin function returns the constant reverse iterator (const_reverse_iterator) pointing to the last element of the list. Please note that, Unlike the list::back function, which returns a direct reference to the last element, it returns the const_reverse_iterator pointing to the same element of the list.

C++ crbegin crend

Note: A const_reverse_iterator is an iterator that points to constant value and iterates in backward direction. Increasing a const_reverse_iterator results into moving to the beginning of the list container and decreasing it results into moving to the end of the list container. Along with this, it cannot be used to modify the contents it points to, even if the list element is not itself constant.

Syntax

const_reverse_iterator crbegin() const noexcept;

Parameters

No parameter is required.

Return Value

A const_reverse_iterator to the reverse beginning of the sequence container.

Time Complexity

Constant i.e, Θ(1).

Example:

In the example below, the list::crbegin function returns the const_reverse_iterator pointing to the last element of the list MyList.

#include <iostream>
#include <list>
using namespace std;
 
int main (){
  list<string> MyList{"Alpha","Coding","Skills"};
  list<string>::const_reverse_iterator crit;

  crit = MyList.crbegin();
  cout<<*crit<<" ";
  crit++;
  cout<<*crit<<" ";
  crit++;
  cout<<*crit<<" ";
  return 0;
}

The output of the above code will be:

Skills Coding Alpha 

Example:

Lets see another example where the list called MyList contains integer values and list::crbegin function is used with list::crend function to specify a range including all elements of the list container.

#include <iostream>
#include <list>
using namespace std;
 
int main (){
  list<int> MyList{10, 20, 30, 40, 50};
  list<int>::const_reverse_iterator crit;

  for(crit = MyList.crbegin(); crit != MyList.crend(); ++crit)
    cout<<*crit<<" ";

  return 0;
}

The output of the above code will be:

50 40 30 20 10 

❮ C++ <list> Library