public member function
<set>
reverse_iterator rend();
const_reverse_iterator rend() const;
reverse_iterator rend() nothrow;
const_reverse_iterator rend() const nothrow;
Return reverse iterator to reverse end
Returns a reverse iterator pointing to the theoretical element right before the first element in the multiset container (which is considered its reverse end).
The range between multiset::rbegin and multiset::rend contains all the elements of the container, in reverse order.
Return Value
A reverse iterator to the reverse end of the sequence container.
If the multiset object is const-qualified, the function returns a const_reverse_iterator. Otherwise, it returns a reverse_iterator.
Member types reverse_iterator and const_reverse_iterator are reverse bidirectional iterator types pointing to elements. See multiset member types.
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
// multiset::rbegin/rend
#include <iostream>
#include <set>
int main ()
{
int myints[] = {77,16,2,30,30};
std::multiset<int> mymultiset (myints,myints+5);
std::cout << "mymultiset contains:";
for (std::multiset<int>::reverse_iterator rit=mymultiset.rbegin() ; rit!=mymultiset.rend(); ++rit)
std::cout << ' ' << *rit;
std::cout << '\n';
return 0;
}
| |
Output:
mymultiset contains: 77 30 30 16 2
|
Iterator validity
No changes.
Data races
The container is accessed (neither the const nor the non-const versions modify the container).
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
- multiset::rbegin
- Return reverse iterator to reverse beginning (public member function
)
- multiset::begin
- Return iterator to beginning (public member function
)
- multiset::end
- Return iterator to end (public member function
)