std::reverse_iterator

 

C++

语言

头文件

库概念

语言支持库

诊断库

工具库

字符串库

容器库

算法库

迭代器库

数值库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

迭代器库

迭代器原语
iterator_traits
input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tag
iterator
迭代器适配器
reverse_iterator move_iterator (C++11) back_insert_iterator front_insert_iterator insert_iterator	make_reverse_iterator (C++14) make_move_iterator (C++11) back_inserter front_inserter inserter
流迭代器
istream_iterator
ostream_iterator
istreambuf_iterator
ostreambuf_iterator
迭代器操作
advance
distance
prev (C++11)
next (C++11)
范围访问
begincbegin (C++11) (C++14)
endcend (C++11) (C++14)
rbegincrbegin (C++14) (C++14)
rendcrend (C++14) (C++14)
容器访问
size (C++17)
empty (C++17)
data (C++17)

 

std::reverse_iterator

成员函数

reverse_iterator::reverse_iterator

reverse_iterator::operator=

reverse_iterator::base

reverse_iterator::operator*reverse_iterator::operator->

reverse_iterator::operator[]

reverse_iterator::operator++reverse_iterator::operator+reverse_iterator::operator+=reverse_iterator::operator--reverse_iterator::operator-reverse_iterator::operator-=

非成员函数

operator==operator!=operator<operator>

operator+

operator-

 

定义于头文件 <iterator>
template< class Iterator > class reverse_iterator : public std::iterator<                            typename std::iterator_traits<Iterator>::iterator_category,                            typename std::iterator_traits<Iterator>::value_type,                            typename std::iterator_traits<Iterator>::difference_type,                            typename std::iterator_traits<Iterator>::pointer,                            typename std::iterator_traits<Iterator>::reference >		(C++17 前)
template< class Iterator > class reverse_iterator;		(C++17 起)

std::reverse_iterator 是一个反转给定迭代器方向的迭代器适配器。换言之，提供双向迭代器时， std::reverse_iterator 产生一个新的迭代器，它从底层的双向迭代器所定义的序列的末尾移动到开端。

对于从迭代器 i 构造的 r 逆向迭代器，关系 &*r == &*(i-1) 始终为 true （只要 r 可解引用）；从而构造自末尾后一位置的迭代器的逆向迭代器解引用到序列的最后元素。

这是标准库容器的成员函数 rbegin() 及 rend() 所返回的迭代器。

成员类型

成员类型	定义
value_type	std::iterator_traits<Iterator>::value_type
difference_type	std::iterator_traits<Iterator>::difference_type
pointer	std::iterator_traits<Iterator>::pointer
reference	std::iterator_traits<Iterator>::reference
iterator_category	std::iterator_traits<Iterator>::iterator_category

要求通过从 std::iterator< std::iterator_traits<Iterator>::iterator_category , std::iterator_traits<Iterator>::value_type , std::iterator_traits<Iterator>::difference_type , std::iterator_traits<Iterator>::pointer , std::iterator_traits<Iterator>::reference > 继承获得这些成员类型。

(C++17 前)

成员类型	定义
iterator_type	Iterator

成员函数

(构造函数)	构造新的迭代器适配器 (公开成员函数)
operator=	赋值另一迭代器 (公开成员函数)
base	访问底层迭代器 (公开成员函数)
operator* operator->	访问指向的元素 (公开成员函数)
operator[]	按索引访问元素 (公开成员函数)
operator++ operator++(int) operator+= operator+ operator-- operator--(int) operator-= operator-	推进或回退迭代器 (公开成员函数)

成员对象

成员名称	定义
current (受保护成员对象)	base() 迭代器的副本

非成员函数

operator== operator!= operator< operator<= operator> operator>=	比较底层迭代器 (函数模板)
operator+	令迭代器前进 (函数模板)
operator-	计算二个迭代器适配器间的距离 (函数模板)

注意

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

参阅

iterator (C++17 中弃用)

简化简单迭代器所要求类型定义的基类 (类模板)