引用属于其他范围的元素的视图。
语法
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::all 或 views::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_view 将 vector 转换为视图,这使得传递向量元素的成本较低。
示例: 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 中的第一个元素的迭代器。
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:
size
获取元素数。
constexpr auto size() const requires sized_range<R>
参数
无。
返回值
ref_view 中的元素的数量。