C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持（基本类型、RTTI、类型特性）
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- std::begin, std::cbegin
- std::end, std::cend
- std::next
- std::reverse_iterator
- std::prev
- std::move_iterator
- std::size, std::ssize
- std::empty
- std::data
- std::reverse_iterator<Iter>::operator++,+,+=,--,-,-=
- std::rbegin, std::crbegin
- std::indirectly_readable
- std::indirectly_writable
- std::weakly_incrementable
- std::insert_iterator
- std::rend, std::crend
- std::incrementable
- std::input_or_output_iterator
- std::sentinel_for
- std::sized_sentinel_for, std::disable_sized_sentinel_for
- std::input_iterator
- std::output_iterator
- std::forward_iterator
- std::bidirectional_iterator
- std::random_access_iterator
- std::contiguous_iterator
- std::iterator_traits
- std::input_iterator_tag, std::output_iterator_tag, std::forward_iterator_tag, std::bidirectional_iterator_tag, std::random_access_iterator_tag, std::contiguous_iterator_tag
- std::iterator
- std::incrementable_traits
- std::indirectly_readable_traits
- std::iter_value_t, std::iter_reference_t, std::iter_difference_t, std::iter_rvalue_reference_t, std::iter_common_reference_t
- std::indirect_unary_invocable, std::indirectly_regular_unary_invocable
- std::indirect_unary_predicate
- std::indirect_binary_predicate
- std::indirect_equivalence_relation
- std::indirect_strict_weak_order
- std::indirectly_movable
- std::indirectly_movable_storable
- std::indirectly_copyable
- std::indirectly_copyable_storable
- std::indirectly_swappable
- std::indirectly_comparable
- std::permutable
- std::mergeable
- std::sortable
- std::indirect_result_t
- std::projected
- std::move_sentinel
- std::back_insert_iterator
- std::front_insert_iterator
- std::make_reverse_iterator
- std::make_move_iterator
- std::default_sentinel_t, std::default_sentinel
- std::unreachable_sentinel_t, std::unreachable_sentinel
- std::back_inserter
- std::front_inserter
- std::inserter
- std::istream_iterator
- std::ostream_iterator
- std::istreambuf_iterator
- std::ostreambuf_iterator
- std::advance
- std::distance
- 注释
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::reverse_iterator
| 定义于头文件 <iterator>
|
||
| template< class Iter > class reverse_iterator : public std::iterator< |
(C++17 前) | |
| template< class Iter > class reverse_iterator; |
(C++17 起) | |
std::reverse_iterator 是一个反转给定迭代器方向的迭代器适配器。换言之，提供双向迭代器时， std::reverse_iterator 产生一个新的迭代器，它从底层的双向迭代器所定义的序列的末尾移动到开端。
对于从迭代器 i 构造的 r 逆向迭代器，关系 &*r == &*(i-1) 始终为 true （只要 r 可解引用）；从而构造自末尾后一位置的迭代器的逆向迭代器解引用到序列的最后元素。
这是标准库容器的成员函数 rbegin() 及 rend() 所返回的迭代器。
成员类型
| 成员类型 | 定义 | ||||
iterator_type
|
Iter
| ||||
iterator_concept(C++20 起) |
若 Iter 实现 std::random_access_iterator ，则为 std::random_access_iterator_tag 。否则为 std::bidirectional_iterator_tag
| ||||
iterator_category
|
| ||||
value_type
|
| ||||
difference_type
|
| ||||
pointer
|
std::iterator_traits<Iter>::pointer | ||||
reference
|
| ||||
|
要求通过从 std::iterator<std::iterator_traits<Iter>::iterator_category |
(C++17 前) |
成员函数
| 构造新的迭代器适配器 (公开成员函数) | |
| 赋值另一迭代器 (公开成员函数) | |
| 访问底层迭代器 (公开成员函数) | |
| 访问指向的元素 (公开成员函数) | |
| 按索引访问元素 (公开成员函数) | |
| 推进或回退迭代器 (公开成员函数) |
成员对象
| 成员名称 | 定义 |
current (受保护成员对象)
|
base() 迭代器的副本 |
非成员函数
| (C++14) |
创建拥有从实参推出的类型的 std::reverse_iterator (函数模板) |
| 比较底层迭代器 (函数模板) | |
| 令迭代器前进 (函数模板) | |
| 计算两个迭代器适配器间的距离 (函数模板) | |
| (C++20) |
转型解引用调整后的底层迭代器的结果为其所关联的右值引用类型 (函数模板) |
| (C++20) |
交换二个调整后的底层迭代器所指向的对象 (函数模板) |
注意
std::reverse_iterator 不可作用于返回到成员对象引用的迭代器（是谓“隐匿迭代器”）。隐匿迭代器的一个例子是 std::filesystem::path::iterator 。
示例
#include <iostream> #include <string> #include <iterator> int main() { std::string s = "Hello, world"; std::reverse_iterator<std::string::iterator> r = s.rbegin(); r[7] = 'O'; // 以 'O' 替换 'o' r += 7; // 迭代器现在指向 'O' std::string rev(r, s.rend()); std::cout << rev << '\n'; }
输出：
OlleH
参阅
| (C++17 中弃用) |
用于简化简单的迭代器的必要类型定义的基类 (类模板) |