W3cubDocs

/C++

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

(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.

range-rbegin-rend.svg

Parameters

(none).

Return value

Reverse iterator to the element following the last element.

Complexity

Constant.

Example

#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

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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/array/rend