join_view 类(C++ 标准库)

将一系列范围的元素合并到单个视图中。

语法

template<input_range R> requires view<R> && input_range<range_reference_t<R>> &&
    (is_reference_v<range_reference_t<R>> || view<range_value_t<R>>)
class join_view : public view_interface<join_view<R>>;

模板参数

R
基础范围的类型。 必须满足input_range或更高范围。

视图特征

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

特征 说明
范围适配器 views::join
基础范围 必须满足 input_range 或更高范围
元素类型 与基础范围相同
视图枚举器类别 最多bidirectional_rangeinput_range,具体取决于要迭代的基础范围
已设置大小
const 可迭代 仅当基础范围为 const 可迭代时
常见范围 仅当基础范围满足 common_range 要求时
借入范围

成员

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

备注

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

如果要将多个范围合并到单个视图中,此视图非常有用。

要求

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

命名空间std::ranges

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

构造函数

创建 join_view的实例。

1) join_view() = default;
2) constexpr explicit join_view(R base)

参数

base
基础范围。

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

注解

1) 默认构造join_view
2) 从base构造join_view

示例: join_view

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

int main()
{
    std::vector<int> rg1{1, 2, 3, 4};
    std::vector<int> rg2{5, 6, 7};
    std::vector<int> rg3{8, 9, 10, 11, 12, 13};
    std::vector<int> rangeOfRanges[] {rg1, rg2, rg3};

    auto jv = std::ranges::join_view(rangeOfRanges);

    for (auto& e : jv)
    {
        std::cout << e << " ";
    }
}
1 2 3 4 5 6 7 8 9 10 11 12 13

base

获取基础视图。

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

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

参数

无。

返回值

  1. 返回的视图是复制构造视图。
  2. 返回的视图是移动构造视图。

begin

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

constexpr auto begin();
constexpr auto begin() const
    requires ranges::input_range<const V> && std::is_reference_v<ranges::range_reference_t<const V>>;

参数

无。

返回值

指向视图中第一个元素的迭代器:

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

end

获取视图末尾的 sentinel。

constexpr sentinel_t<R> end();
constexpr auto end() const requires range<const R>

参数

无。

返回值

视图中最后一个元素后面的 sentinel:

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

另请参阅

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