public member function
<set>

std::multiset::rend

      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.

Parameters

none

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


Complexity

Constant.

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