ref_view 类(C++ 标准库)

引用属于其他范围的元素的视图。

语法

template<std::ranges::range R>
    requires std::is_object_v<R>
class ref_view : public ranges::view_interface<ref_view<R>>;

模板参数

R
要引用的范围。

成员

成员函数 描述
构造函数C++20 构造 ref_view
baseC++20 获取对基础范围的引用。
beginC++20 获取指向第一个元素的迭代器。
dataC++20 获取指向所引用区域中第一个元素的指针。
emptyC++20 测试此 ref_view 是否为空。
endC++20 获取此 ref_view 末尾的 sentinel。
sizeC++20 获取元素数。 基础范围必须满足 sized_range
view_interface 继承 描述
backC++20 获取最后一个元素。
frontC++20 获取第一个元素。
operator[]C++20 获取指定位置的元素。
operator boolC++20 测试此 ref_view 是否不为空。

视图特征

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

特征 说明
范围适配器 views::allviews::common
基础范围 必须满足 input_range
元素类型 与基础范围相同
视图迭代器类别 与基础范围相同
已设置大小 仅当基础范围满足 sized_range 要求时
const 可迭代
常见范围 仅当基础范围满足 common_range 要求时
借入范围

要求

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

命名空间std::ranges

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

构造函数

构造 ref_view 的实例

// construct a ref_view from a range
template<different-from<ref_view> R>
constexpr ref_view(R&& rg);

参数

rg
要引用的范围。

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

返回值

一个 ref_view 实例。

注解

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

ref_view 可用于将容器转换为视图。 例如,可以使用 ref_viewvector 转换为视图,这使得传递向量元素的成本较低。

示例: ref_view

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

int main()
{
    std::vector<int> v = {1,2,3};
    auto refView = std::views::all(v);
    std::cout << &refView[1] << " : " << &v[1]; // outputs two identical memory addresses, e.g. 00000239AFAFDF90 : 00000239AFAFDF90
    refView[0] = 10; // modifies v[0]
    std::cout << "\n" << v[0]; // 10
}
00000239AFAFDF90 : 00000239AFAFDF90
10

base

获取基础范围的副本。

constexpr R& base() const;

参数

无。

返回值

基础范围。

begin

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

constexpr iterator_t<R> begin() const;

参数

无。

返回值

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

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

data

获取指向此 ref_view 中第一个元素的指针。 范围中的元素必须连续。

constexpr auto data() const requires contiguous_range<R>;

参数

无。

返回值

指向第一个元素的指针。

empty

测试此 ref_view 是否为空。

constexpr bool empty() const

参数

无。

返回值

如果 ref_view 不包含任何元素,则返回 true。 否则为 false

end

获取此 ref_view 末尾的 sentinel。

constexpr sentinel_t<R> end() const

返回值

ref_view 中最后一个元素后面的 sentinel:

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

size

获取元素数。

constexpr auto size() const requires sized_range<R>

参数

无。

返回值

ref_view 中的元素的数量。

另请参阅

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