common_view 类（C++ 标准库）
采用可能具有不同迭代器和 sentinel 类型的范围，并创建具有相同迭代器和 sentinel 类型的视图。 对于调用接受迭代器对指定的范围的 STL 算法，这非常有用。
语法
template<ranges::view V>
requires (!ranges::common_range<V> && std::copyable<ranges::iterator_t<V>>)
class common_view : public ranges::view_interface<common_view<V>>;
模板参数
V
基础视图的类型。
视图特征
有关下列条目的说明，请参阅视图类特征
| 特征 | 说明 |
|---|---|
| 范围适配器 | views::common |
| 基础范围 | 必须满足 forward_range 或更高范围 |
| 元素类型 | 与基础范围相同 |
| 视图迭代器类别 | 基础范围满足 random_access_range 和 sized_range 要求时为 forward_range 或 random_access_range |
| 已设置大小 | 仅当基础范围满足 sized_range 要求时 |
是 const 可迭代 |
仅当基础范围为 const 可迭代时 |
| 常见范围 | 是 |
| 借入范围 | 仅当基础范围满足 borrowed_range 要求时 |
成员
| 成员函数 | 描述 |
|---|---|
| 构造函数C++20 | 构造 common_view。 |
baseC++20 |
获取基础视图。 |
beginC++20 |
获取指向视图中第一个元素的迭代器。 |
endC++20 |
获取视图末尾的 sentinel。 |
sizeC++20 |
获取视图中的元素数。 |
从 view_interface 继承 |
描述 |
backC++20 |
获取最后一个元素。 |
dataC++20 |
获取指向第一个元素的指针。 |
emptyC++20 |
测试视图是否为空。 |
frontC++20 |
获取第一个元素。 |
operator[]C++20 |
获取指定位置的元素。 |
operator boolC++20 |
测试视图是否不为空。 |
备注
创建 common_view 的最佳方法是使用 views::common 范围适配器。 范围适配器是创建视图类的预期方法。 如果要创建自己的自定义视图类型，会公开视图类型。
对于将具有不同迭代器/sentinel 类型的范围传递给期望它们相同的旧算法，此视图非常有用。
要求
标头： <ranges> （自C++20以来）
命名空间：std::ranges
编译器选项：/std:c++20或更高版本是必需的。
构造函数
创建 common_view的实例。
1) common_view() = default;
2) constexpr explicit common_view(V v);
参数
v
基础视图。
有关模板参数类型的信息，请参阅模板参数。
注解
1) 默认构造 common_view。
2） 使用 std::move(v) 从基础视图构造 common_view。 如果 V 为常见范围，则会产生错误，以避免误用对性能产生负面影响。
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
获取指向第一个元素的迭代器。
constexpr auto begin();
constexpr auto begin() const requires range<const V>;
返回值
指向视图中第一个元素的迭代器：
end
获取视图末尾的 sentinel。
constexpr auto end();
constexpr auto end() const requires ranges::range<const V>;
返回值
视图中最后一个元素后面的 sentinel：
size
获取视图中的元素数。
constexpr auto size() requires ranges::sized_range<V>;
constexpr auto size() const requires ranges::sized_range<const V>;
参数
无。
返回值
视图中的元素数。