命名空间
变体
操作

std::rend, std::crend

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

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

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

range-rbegin-rend.svg

目录

[编辑] 参数

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-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';
}

输出

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

[编辑] 参阅

(C++11)(C++14)
 返回指向容器或数组末尾的迭代器
(函数模板) [编辑]
(C++14)
 返回指向容器或数组开头的反向迭代器
(函数模板) [编辑]
(C++11)(C++14)
 返回指向容器或数组开头的迭代器
(函数模板) [编辑]
(C++20)
 返回指向范围的反向结束迭代器
(自定义点对象)[编辑]
(C++20)
 返回只读范围的反向结束迭代器
(自定义点对象)[编辑]
取自 "https://cppreference.cn/mwiki/index.php?title=cpp/iterator/rend&oldid=177486"