# std::array<T,N>::rend, std::array<T,N>::crend

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

| (1) |
reverse_iterator rend() noexcept; |  | (until C++17)
constexpr reverse_iterator rend() noexcept; |  | (since C++17)
| (2) |
const_reverse_iterator rend() const noexcept; |  | (until C++17)
constexpr const_reverse_iterator rend() const noexcept; |  | (since C++17)
| (3) |
const_reverse_iterator crend() const noexcept; |  | (until C++17)
constexpr const_reverse_iterator crend() const noexcept; |  | (since C++17)

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

### Parameters

(none)

### Return value

Reverse iterator to the element following the last element.

### Complexity

Constant.

### Example

Run this code

    #include <algorithm>
    #include <array>
    #include <iostream>

    int main()
    {
        std::array<int, 11> a {1, 11, 11, 35, 0, 12, 79, 76, 76, 69, 40};

        // print elements of array in reverse order using const_reverse_iterator`s
        std::for_each(a.crbegin(), a.crend(), [](int e){ std::cout << e << ' '; });
        //              ^^           ^^
        std::cout << '\n';

        // modify each element of array using non-const reverse_iterator`s
        std::for_each(a.rbegin(), a.rend(), [](int& e){ e += 32; });
        //              ^           ^             ^

        // print elements as chars in reverse order using const_reverse_iterator`s
        std::for_each(a.crbegin(), a.crend(), [](char e){ std::cout << e; });
        //              ^^           ^^          ^^^^
        std::cout << '\n';
    }

Output:

    40 69 76 76 79 12 0 35 11 11 1
    Hello, C++!

### See also

rbegin crbegin (C++11) | returns a reverse iterator to the beginning (public member function)
rend crend (C++14) | returns a reverse end iterator for a container or array (function template)

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/container/array/rend&oldid=122727"