public member function
<set>
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).
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 const elements.
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// multiset::crbegin/crend
#include <iostream>
#include <set>
int main ()
{
std::multiset<int> mymultiset = {10,20,30,20,10};
std::cout << "mymultiset backwards:";
for (auto rit=mymultiset.crbegin(); rit != mymultiset.crend(); ++rit)
std::cout << ' ' << *rit;
std::cout << '\n';
return 0;
}
Output:
mymultiset backwards: 30 20 20 10 10
Iterator validity
No changes.
Data races
The container is accessed.
Concurrently accessing the elements of a multiset 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
- multiset::end
- Return iterator to end (public member function)
- multiset::crbegin
- Return const_reverse_iterator to reverse beginning (public member function)
- multiset::rend
- Return reverse iterator to reverse end (public member function)