Namespaces
Variants

    std::rend, std::crend

    来自 zh.cppreference.net
     
    C++
     
    迭代器库
    迭代器概念
    迭代器原语
    算法概念与工具
    间接可调用概念
    通用算法要求
    (C++20)
    (C++20)
    (C++20)
    工具
    (C++20)
    迭代器适配器
    范围访问
    (C++11)(C++14)
    (C++14)(C++14)  
    (C++11)(C++14)
    (C++14)(C++14)  
    (C++17)(C++20)
    (C++17)
    (C++17)
     
    定义于头文件 <array>
    定义于头文件 <deque>
    定义于头文件 <flat_map>
     (自 C++23 起)
    定义于头文件 <flat_set>
     (自 C++23 起)
    定义于头文件 <forward_list>
    定义于头文件 <inplace_vector>
     (自 C++26 起)
    定义于头文件 <iterator>
    定义于头文件 <list>
    定义于头文件 <map>
    定义于头文件 <optional>
     (自 C++26 起)
    定义于头文件 <regex>
    定义于头文件 <set>
    定义于头文件 <span>
     (自 C++20 起)
    定义于头文件 <stacktrace>
     (自 C++23 起)
    定义于头文件 <string>
    定义于头文件 <string_view>
     (自 C++17 起)
    定义于头文件 <unordered_map>
    定义于头文件 <unordered_set>
    定义于头文件 <valarray>
    定义于头文件 <vector> 
    template< class C >
auto rend( C& c ) noexcept(noexcept(c.rend()))
    -> decltype(c.rend());
    		(1) (自 C++14 起)
    (自 C++17 起 constexpr)    		 
    template< class C >
auto rend( const C& c ) noexcept(noexcept(c.rend()))
    -> decltype(c.rend());
    		(2) (自 C++14 起)
    (自 C++17 起 constexpr)    		 
    template< class T, std::size_t N >
std::reverse_iterator<T*> rend( T (&array)[N] ) noexcept;
    		(3) (自 C++14 起)
    (自 C++17 起 constexpr)    		 
    template< class T >
std::reverse_iterator<const T*> rend( std::initializer_list<T> il ) noexcept;
    		(4) (自 C++14 起)
    (自 C++17 起 constexpr)    		 
    template< class C >
auto crend( const C& c ) noexcept(noexcept(std::rend(c)))
    -> decltype(std::rend(c));
    		(5) (自 C++14 起)
    (自 C++17 起 constexpr)

    返回指向给定范围的反向末尾的迭代器。

    1,2) 返回 c.rend()，通常是表示序列 c 的反向末尾后一个位置的迭代器。
    1) 若 C 是标准 Container，则返回 C::reverse_iterator 对象。
    2) 若 C 是标准 Container，则返回 C::const_reverse_iterator 对象。
    3) 返回指向 std::reverse_iterator<T*> 的反向末尾的 array 对象。
    4) 返回指向 std::reverse_iterator<const T*> 的反向末尾的 il 对象。
    5) 返回 std::end(c)，其中 c 始终被视为 const 限定。
    若 C 是标准 Container，则返回 C::const_reverse_iterator 对象。

    参数

    c - 具有 rend 成员函数的容器或视图
    array - 任意类型的数组
    il - 一个 std:: initializer_list

    返回值

    1,2) c. rend ( )
    3) std:: reverse_iterator < T * > ( array )
    4) std:: reverse_iterator < const T * > ( il. begin ( ) )
    5) c. rend ( )

    异常

    可能抛出实现定义的异常。

    重载

    对于无法提供合适的 rend() 成员函数但仍可迭代的类和枚举类型，可以提供自定义的 rend 重载版本。

    通过 实参依赖查找 找到的 rend 重载可用于自定义 std :: ranges:: rend 和 std::ranges::crend 的行为。

    		(C++20 起)

    注释

    针对 std::initializer_list 的重载是必需的，因为它没有成员函数 rend 。

    示例

    运行此代码 
    #include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
int main()
{
    int a[]{4, 6, -3, 9, 10};
    std::cout << "C 风格数组 `a` 反向输出: ";
    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` 反向输出: ";
    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` 反向输出: ";
    std::copy(std::rbegin(v), std::rend(v), std::ostream_iterator<int>(std::cout, " "));
    std::cout << '\n';
}

    输出： 

    C 风格数组 `a` 反向输出: 10 9 -3 6 4
std::initializer_list `il` 反向输出: 4 1 3
std::vector `v` 反向输出: 10 9 -3 6 4

    缺陷报告

    以下影响行为的缺陷报告已追溯应用于先前发布的 C++ 标准。

    DR 适用标准 发布时的行为 正确行为
    LWG 3537 C++14 std::rend 和 std::crend 未被要求传播异常说明 要求传播

    参见

    (C++11) (C++14)
    		返回指向容器或数组末尾的迭代器
    (函数模板)
    (C++14)
    		返回指向容器或数组起始的反向迭代器
    (函数模板)
    (C++11) (C++14)
    		返回指向容器或数组起始的迭代器
    (函数模板)
    (C++20)
    		返回指向范围反向末尾的迭代器
    (定制点对象)
    (C++20)
    		返回指向只读范围反向末尾的迭代器
    (定制点对象)