# std::array<T,N>::rbegin, std::array<T,N>::crbegin

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

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

## Official Specification Summary (cppreference)

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

Returns a reverse iterator to the first element of the reversed `array`. It corresponds to the last element of the non-reversed `array`. If the `array` 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.

### Example

```cpp
#include <algorithm>
#include <array>
#include <iostream>
#include <string>
#include <string_view>

void print(const std::string_view s) { std::cout << s << ' '; }

int main()
{
    const std::array<std::string_view, 8> data
    {
        "▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"
    };
    std::array<std::string, 8> arr;

    std::copy(data.cbegin(), data.cend(), arr.begin());

    print("Print 'arr' in direct order using [cbegin, cend):\t");
    std::for_each(arr.cbegin(), arr.cend(), print);

    print("\n\nPrint 'arr' in reverse order using [crbegin, crend):\t");
    std::for_each(arr.crbegin(), arr.crend(), print);
}
```

Output:

```text
Print 'arr' in direct order using [cbegin, cend):        ▁ ▂ ▃ ▄ ▅ ▆ ▇ █

Print 'arr' in reverse order using [crbegin, crend):     █ ▇ ▆ ▅ ▄ ▃ ▂ ▁
```

### See also

- [`rend`](https://en.cppreference.com/w/cpp/container/array/rend), [`crend`](https://en.cppreference.com/w/cpp/container/array/rend): 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/array/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.