elements_view 类（C++ 标准库）
查看区域中每个类似元组的值的选定索引处的元素。 例如，给定 std::tuple<string, int> 范围后，创建一个视图，其中包含每个元组中的 string 元素。
语法
template<input_range V, size_t N>
class elements_view : public view_interface<elements_view<V, N>>;
模板参数
N
要为视图选择的元素的索引。
V
基础范围的类型。 此类型必须满足 ranges::input_range 要求。
视图特征
有关下列条目的说明，请参阅视图类特征
| 特征 | 说明 |
|---|---|
| 范围适配器 | views::elements |
| 基础范围 | 必须满足 input_range 或更高范围 |
| 元素类型 | 与索引元组元素的类型相同 |
| 视图枚举器类别 | forward_range、bidirectional_range 或 random_access_range |
| 已设置大小 | 仅当基础范围满足 sized_range 要求时 |
是 const 可迭代 |
仅当基础范围满足 const-iterable 要求时 |
| 常见范围 | 仅当基础范围满足 common_range 要求时 |
| 借入范围 | 仅当基础范围满足 borrowed_range 要求时 |
成员
| 成员函数 | 描述 |
|---|---|
| 构造函数C++20 | 构造 elements_view。 |
baseC++20 |
获取基础范围。 |
beginC++20 |
获取指向第一个元素的迭代器。 |
endC++20 |
获取视图末尾的 sentinel。 |
sizeC++20 |
获取此视图中的元素数。 基础范围必须满足 sized_range 要求。 |
从 view_interface 继承 |
描述 |
backC++20 |
获取最后一个元素。 |
emptyC++20 |
测试 elements_view 是否为空。 |
frontC++20 |
获取第一个元素。 |
operator[]C++20 |
获取指定位置的元素。 |
operator boolC++20 |
测试 elements_view 是否不为空。 |
要求
标头： <ranges> （自C++20以来）
命名空间：std::ranges
编译器选项：/std:c++20或更高版本是必需的。
备注
可用于 elements_view 的类似元组的类型为 std::tuple、std::pair 和 std::array。
构造函数
构造 elements_view 的实例。
1) constexpr elements_view(V base);
2) elements_view() requires std::default_initializable<V> = default;
参数
base
基础范围。
有关模板参数类型的信息，请参阅模板参数。
返回值
一个 elements_view 实例。
备注
创建 elements_view 的最佳方法是使用 elements 范围适配器。 范围适配器是创建视图类的预期方法。 如果要创建自己的自定义视图类型，会公开视图类型。
1) 从指定视图创建一个 elements_view。
2） 默认构造一个 elements_view。
示例： elements_view
// requires /std:c++20 or later
#include <array>
#include <iostream>
#include <map>
#include <ranges>
#include <vector>
#include <string>
#include <utility>
int main()
{
// ========== work with a std::map
std::map<std::string, int> cpp_standards
{
{"C++98", 1988},
{"C++03", 2003},
{"C++11", 2011},
{"C++14", 2014},
{"C++17", 2017},
{"C++20", 2020}
};
// create an elements_view of all the string elements (<1>) from each tuple
for (int const year : std::views::elements<1>(cpp_standards))
{
std::cout << year << ' '; // 2003 2011 2014 2017 1988 2020
}
std::cout << '\n';
// Another way to call the range adaptor using pipe (|) syntax
for (auto&& name : cpp_standards | std::views::elements<0>)
{
std::cout << name << ' '; // C++03 C++11 C++14 C++17 C++98 C++20
}
std::cout << '\n';
// ========== working with arrays
std::array<std::array<int, 4>, 3> arr = { {{0,1,2,3}, {4,5,6,7}, {8,9,10,11}} };
for (int& fourth : arr | std::views::elements<3>)
{
std::cout << fourth << ' '; // 3 7 11
}
std::cout << '\n';
// ========== work with a std::pair
std::vector<std::pair<std::string, int>> windows
{
{"Windows 1.0", 1985},
{"Windows 2.0", 1987},
{"Windows 3.0", 1990},
{"Windows 3.1", 1992},
{"Windows NT 3.1", 1993},
{"Windows 95", 1995},
{"Windows NT 4.0", 1996},
{"Windows 98", 1998},
{"Windows 2000", 2000}
};
for (int year : std::views::elements<1>(windows))
{
std::cout << year << ' '; // 1985 1987 1990 1992 1993 1995 1996 1998 2000
}
}
2003 2011 2014 2017 1988 2020
C++03 C++11 C++14 C++17 C++98 c++20
3 7 11
1985 1987 1990 1992 1993 1995 1996 1998 2000
base
获取基础范围的副本。
// Uses a copy constructor to return the underlying range
constexpr V base() const& requires std::copy_constructible<V>;
// Uses a move constructor to return the underlying range
constexpr V base() &&;
参数
无。
返回值
基础范围。
begin
获取指向 elements_view 中第一个元素的迭代器。
1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires range<const V>;
参数
无。
返回值
指向 elements_view 中的第一个元素的迭代器。
end
获取 elements_view 末尾的 sentinel
1) constexpr auto end() requires (!Simple_view<V> && !ranges::common_range<V>);
2) constexpr auto end() requires (!Simple_view<V> && ranges::common_range<V>);
3) constexpr auto end() const requires ranges::range<const V>;
4) constexpr auto end() const requires ranges::common_range<const V>;
参数
无。
返回值
elements_view 中最后一个元素后面的 sentinel：
size
获取视图中的元素数。
constexpr auto size() requires sized_range<V>;
constexpr auto size() const requires sized_range<const V>;
参数
无。
返回值
elements_view 中的元素的数量。
备注
仅当基础范围是 sized_range（换句话说，有边界）时，视图的大小才可用。