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

From cppreference.com
< cpp‎ | container‎ | array

 
 
 
std::array
Member types
Member functions
Element access
Iterators
array::rbeginarray::crbegin
Capacity
Operations
Non-member functions
(哋它亢++11)
(哋它亢++11)
(哋它亢++20)
(哋它亢++11)(哋它亢++11)(until 哋它亢++20)(哋它亢++11)(until 哋它亢++20)(哋它亢++11)(until 哋它亢++20)(哋它亢++11)(until 哋它亢++20)(哋它亢++11)(until 哋它亢++20)(哋它亢++20)
Helper classes
(哋它亢++11)
Deduction guides (哋它亢++17)
 
reverse_iterator rbegin() noexcept;
(1) (since 哋它亢++11)
(constexpr since 哋它亢++17)
const_reverse_iterator rbegin() const noexcept;
(2) (since 哋它亢++11)
(constexpr since 哋它亢++17)
const_reverse_iterator crbegin() const noexcept;
(3) (since 哋它亢++11)
(constexpr since 哋它亢++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().

range-rbegin-rend.svg

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

#include <algorithm>
#include <array>
#include <iostream>
#include <string>
#include <string_view>
 
int main()
{
    constexpr std::array<std::string_view, 8> data = {"▁","▂","▃","▄","▅","▆","▇","█"};
 
    std::array<std::string, std::size(data)> arr;
 
    std::copy(data.cbegin(), data.cend(), arr.begin());
    //             ^              ^           ^
 
    auto print = [](const std::string_view s) { std::cout << s << ' '; };
 
    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);
    //                ^^             ^^
    print("\n");
}

Output:

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

See also

returns a reverse iterator to the end
(public member function)
(哋它亢++14)
returns a reverse iterator to the beginning of a container or array
(function template)