std::rend, std::crend
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Iterator library
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++23)(C++20)(C++20)
(deprecated in C++17)
(C++20)
(C++20)
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++14)
(C++11)
(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++23)
(C++23)
(C++23)
(C++23)
(C++23)
(C++11)(C++14)
(C++14)(C++14)
(C++11)(C++14)
rendcrend
(C++14)(C++14)
Defined in header
<array>
Defined in header
<deque>
Defined in header
<flat_map>
Defined in header
<flat_set>
Defined in header
<forward_list>
Defined in header
<inplace_vector>
Defined in header
<iterator>
Defined in header
<list>
Defined in header
<map>
Defined in header
<regex>
Defined in header
<set>
Defined in header
<span>
Defined in header
<string>
Defined in header
<string_view>
Defined in header
<unordered_map>
Defined in header
<unordered_set>
Defined in header
<vector>
template< class C >
auto rend( C& c ) -> decltype(c.rend());
(1)
(since C++14) auto rend( C& c ) -> decltype(c.rend());
(constexpr since C++17)
template< class C >
auto rend( const C& c ) -> decltype(c.rend());
(2)
(since C++14) auto rend( const C& c ) -> decltype(c.rend());
(constexpr since C++17)
template< class T, std::size_t N >
std::reverse_iterator <T*> rend( T (&array)[N] );
(3)
(since C++14) std::reverse_iterator <T*> rend( T (&array)[N] );
(constexpr since C++17)
template< class T >
std::reverse_iterator <const T*> rend( std::initializer_list <T> il );
(4)
(since C++14) std::reverse_iterator <const T*> rend( std::initializer_list <T> il );
(constexpr since C++17)
template< class C >
auto crend( const C& c ) -> decltype(std::rend(c));
(5)
(since C++14) auto crend( const C& c ) -> decltype(std::rend(c));
(constexpr since C++17)
Returns an iterator to the reverse-end of the given range.
1,2) Returns c.rend(), which is typically an iterator one past the reverse-end of the sequence represented by c.
[edit] Parameters
c
-
a container or view with a
rend member function
array
-
an array of arbitrary type
il
-
an std::initializer_list
[edit] Return value
1,2) c.rend()
3) std::reverse_iterator <T*>(array)
4) std::reverse_iterator <const T*>(il.begin())
5) c.rend()
[edit] Exceptions
May throw implementation-defined exceptions.
[edit] Overloads
Custom overloads of rend may be provided for classes and enumerations that do not expose a suitable rend() member function, yet can be iterated.
Overloads of rend found by argument-dependent lookup can be used to customize the behavior of std::ranges::rend and std::ranges::crend .
[edit] Notes
The overload for std::initializer_list is necessary because it does not have a member function rend.
[edit] Example
Run this code
#include <algorithm> #include <iostream> #include <iterator> #include <vector> int main() { int a[]{4, 6, -3, 9, 10}; std::cout << "C-style array `a` backwards: "; std::copy (std::rbegin (a), std::rend(a), std::ostream_iterator <int>(std::cout, " ")); auto il = {3, 1, 4}; std::cout << "\nstd::initializer_list `il` backwards: "; std::copy (std::rbegin (il), std::rend(il), std::ostream_iterator <int>(std::cout, " ")); std::vector <int> v{4, 6, -3, 9, 10}; std::cout << "\nstd::vector `v` backwards: "; std::copy (std::rbegin (v), std::rend(v), std::ostream_iterator <int>(std::cout, " ")); std::cout << '\n'; }
Output:
C-style array `a` backwards: 10 9 -3 6 4 std::initializer_list `il` backwards: 4 1 3 std::vector `v` backwards: 10 9 -3 6 4
[edit] See also
(C++14)
(function template) [edit]
(C++11)(C++14)
(function template) [edit]