# std::map<Key,T,Compare,Allocator>::rbegin, std::map<Key,T,Compare,Allocator>::crbegin

> C++ Atlas: `cppatlas.com/w/cpp/container/map/rbegin` | Source: https://en.cppreference.com/w/cpp/container/map/rbegin | Domain: Containers | Standards: C++11, C++14

Returns a reverse iterator to the first element of the reversed map. It corresponds to the last element of the non-reversed map.

## Official Specification Summary (cppreference)

```cpp
reverse_iterator rbegin(); // (1) (noexcept since C++11)
const_reverse_iterator rbegin() const; // (2) (noexcept since C++11)
const_reverse_iterator crbegin() const noexcept; // (3) (since C++11)
```

Returns a reverse iterator to the first element of the reversed `map`. It corresponds to the last element of the non-reversed `map`. If the `map` is empty, the returned iterator is equal to `rend()`.

### Parameters

(none)

### Return value

Reverse iterator to the first element.

### Complexity

Constant.

### Notes

The underlying iterator of the returned reverse iterator is the end iterator. Hence the returned iterator is invalidated if and when the end iterator is invalidated.

libc++ backports `crbegin()` to C++98 mode.

### Example

```cpp
#include <iomanip>
#include <iostream>
#include <string_view>
#include <map>

int main()
{
    const std::map<int, std::string_view> coins
    {
        {10, "dime"},
        {100, "dollar"},
        {50, "half dollar"},
        {5, "nickel"},
        {1, "penny"},
        {25, "quarter"}
    }; // initializer entries in name alphabetical order

    std::cout << "US coins in circulation, largest to smallest denomination:\n";
    for (auto it = coins.crbegin(); it != coins.crend(); ++it)
        std::cout << std::setw(11) << it->second << " = ¢" << it->first << '\n';
}
```

Output:

```text
US coins in circulation, largest to smallest denomination:
     dollar = ¢100
half dollar = ¢50
    quarter = ¢25
       dime = ¢10
     nickel = ¢5
      penny = ¢1
```

### See also

- [`rend`](https://en.cppreference.com/w/cpp/container/map/rend), [`crend`](https://en.cppreference.com/w/cpp/container/map/rend) (C++11): returns a reverse iterator to the end (public member function)
- [`rbegin`](https://en.cppreference.com/w/cpp/iterator/rbegin) (C++14), [`crbegin`](https://en.cppreference.com/w/cpp/iterator/rbegin): returns a reverse iterator to the beginning of a container or array (function template)

---
Attribution: content from https://en.cppreference.com/w/cpp/container/map/rbegin (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.