Namespaces
Variants
Views
Actions

std::multimap<Key,T,Compare,Allocator>::rend, std::multimap<Key,T,Compare,Allocator>::crend

From cppreference.com
< cpp‎ | container‎ | multimap
 
 
 
 
(1)
reverse_iterator rend();
(until C++11)
reverse_iterator rend() noexcept;
(since C++11)
(2)
const_reverse_iterator rend() const;
(until C++11)
const_reverse_iterator rend() const noexcept;
(since C++11)
const_reverse_iterator crend() const noexcept;
(3) (since C++11)

Returns a reverse iterator to the element following the last element of the reversed multimap. It corresponds to the element preceding the first element of the non-reversed multimap. This element acts as a placeholder, attempting to access it results in undefined behavior.

range-rbegin-rend.svg

Contents

[edit] Parameters

(none)

[edit] Return value

Reverse iterator to the element following the last element.

[edit] Complexity

Constant.

Notes

libc++ backports crend() to C++98 mode.

[edit] Example

#include <chrono>
#include <iomanip>
#include <iostream>
#include <string_view>
#include <map>
 
using namespace std::chrono;
 
int main()
{
    const std::multimap<year_month_day, int> messages
    {
        {February/17/2023, 10},
        {February/17/2023, 20},
        {February/16/2022, 30},
        {October/22/2022, 40},
        {June/14/2022, 50},
        {November/23/2021, 60},
        {December/10/2022, 55},
        {December/12/2021, 45},
        {April/1/2020, 42},
        {April/1/2020, 24}
    };
 
    std::cout << "Messages received (date order is reversed):\n";
    for (auto it = messages.crbegin(); it != messages.crend(); ++it)
        std::cout << it->first << " : " << it->second << '\n';
}

Possible output:

Messages received (date order is reversed):
2023-02-17 : 20
2023-02-17 : 10
2022-12-10 : 55
2022-10-22 : 40
2022-06-14 : 50
2022-02-16 : 30
2021-12-12 : 45
2021-11-23 : 60
2020-04-01 : 24
2020-04-01 : 42

[edit] See also

returns a reverse iterator to the beginning
(public member function) [edit]
(C++14)
returns a reverse end iterator for a container or array
(function template) [edit]