reverse_view 类(C++ 标准库)

以倒序显示范围的元素。

语法

template<ranges::view V>
requires ranges::bidirectional_range<V>
class reverse_view : public ranges::view_interface<reverse_view<V>>;

模板参数

V
基础视图的类型。
此类型必须满足 ranges::bidirectional_range 要求。

视图特征

有关下列条目的说明,请参阅视图类特征

特征 说明
范围适配器 views::reverse
基础范围 必须满足 bidirectional_range(最多到 random_access_range)的要求
元素类型 与基础范围相同
视图迭代器类别 与基础范围相同
已设置大小 仅当基础范围满足 sized_range 要求时
const 可迭代 仅当基础范围是 common_view 且满足 const-iterable 要求时
常见范围
借入范围 仅当基础范围满足 borrowed_range 要求时

成员

成员函数 描述
构造函数C++20 构造 reverse_view
baseC++20 获取基础范围。
beginC++20 获取指向第一个元素的迭代器。
endC++20 获取 reverse_view 末尾的 sentinel。
sizeC++20 获取元素数。
view_interface 继承 描述
backC++20 获取最后一个元素。
emptyC++20 测试 reverse_view 是否为空。
frontC++20 获取第一个元素。
operator[]C++20 获取指定位置的元素。
operator boolC++20 测试 reverse_view 是否不为空。

要求

标头: <ranges> (自C++20以来)

命名空间std::ranges

编译器选项:/std:c++20或更高版本是必需的。

构造函数

从双向视图构造 reverse_view 的实例。

1) reverse_view() requires default_initializable<V> = default; // default-constructs the underlying view
2) constexpr explicit reverse_view(V rg); // initializes the underlying view via std::move(r)

参数

rg
要提供反向视图的视图。

有关模板参数类型的信息,请参阅模板参数

返回值

基础范围的视图,按倒序排列。

备注

创建 reverse_view 的最佳方法是使用 views::reverse 范围适配器。 范围适配器是创建视图类的预期方法。 如果要创建自己的自定义视图类型,会公开视图类型。

1) 默认构造函数默认初始化 reverse_view
2) 从指定视图创建一个 reverse_view

示例: reverse_view

// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>

int main()
{
    std::vector<int> v{0, 1, 2, 3, -4, 5, 6};
    auto rv = v | std::views::reverse;
    
    for (auto e : rv) // 6 5 -4 3 2 1 0
    {
        std::cout << e << ' ';
    }
}
6 5 -4 3 2 1 0

base

获取基础视图的副本。

// Uses a copy constructor to return the underlying view
constexpr V base() const& requires std::copy_constructible<V>;

// Uses a move constructor to return the underlying view
constexpr V base() &&;

参数

无。

返回值

基础视图。

begin

获取指向 reverse_view 中第一个元素的迭代器。

1) constexpr reverse_iterator<iterator_t<V>> begin();
2) constexpr reverse_iterator<iterator_t<V>> begin() requires common_range<V>;
3) constexpr auto begin() const requires common_range<const V>;

参数

无。

返回值

指向 reverse_view 中的第一个元素的迭代器。

包含元素 10、20 和 30 的矢量的图片。第一个元素包含 10,被标记为 begin()。最后一个元素包含 30,被标记为“last element”。最后一个元素之后的虚框指示 sentinel,被标记为 end()。

注解

在第一次调用 begin()后,无论 reverse_view中有多少个元素,后续调用都会以常数时间 O(1) 运行。 这有影响,因为 reverse_view 缓存 last 的值,以便它可以重复从 begin 中返回它。 这意味着修改基础容器后,不应重复使用视图。 如果修改了基础范围,请生成新视图,这种做法的成本较低。

2) 基础视图必须满足 common_range 要求,这意味着基础视图必须具有相同的开始和结束迭代器类型。
3) 基础视图必须满足常数视图的 common_range 要求才能循环访问 const reverse_view

end

获取 reverse_view 末尾的 sentinel

1) constexpr reverse_iterator<iterator_t<V>> end();
2) constexpr auto end() const requires common_range<const V>;

参数

无。

返回值

reverse_view 中最后一个元素后面的 sentinel。

包含元素 10、20 和 30 的矢量的图片。第一个元素包含 10,被标记为 begin()。最后一个元素包含 30,被标记为“last element”。最后一个元素之后的虚框指示 sentinel,被标记为 end()。

注解

对于 2,基础视图必须满足常数视图的 common_range 要求,这意味着基础视图必须具有相同的开始和结束迭代器类型。

size

获取元素数。

constexpr auto size() requires ranges::sized_range<V>;
constexpr auto size() const requires ranges::sized_range<const V>;

参数

无。

返回值

reverse_view 中的元素的数量。

备注

仅当基础范围是 sized_range(换句话说,有边界)时,视图的大小才可用。

另请参阅

<ranges>
reverse 范围适配器
视图类