public member function
<set>

std::set::crend

const_reverse_iterator crend() const noexcept;
Return const_reverse_iterator to reverse end
Returns a const_reverse_iterator pointing to the element that would theoretically precede the first element in the container (which is considered its reverse end).

Parameters

none

Return Value

A const_reverse_iterator to the reverse end of the sequence.

Member type const_reverse_iterator is a bidirectional iterator type that points to a const element.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// set::crbegin/crend
#include <iostream>
#include <set>

int main ()
{
  std::set<int> myset = {50,20,60,10,25};

  std::cout << "myset backwards:";
  for (auto rit=myset.crbegin(); rit != myset.crend(); ++rit)
    std::cout << ' ' << *rit;

  std::cout << '\n';

  return 0;
}

Output:
myset backwards: 60 50 25 20 10


Complexity

Constant.

Iterator validity

No changes.

Data races

The container is accessed.
Concurrently accessing the elements of a set is safe.

Exception safety

No-throw guarantee: this member function never throws exceptions.
The copy construction or assignment of the returned iterator is also guaranteed to never throw.

See also