std::ranges::views::zip, std::ranges::zip_view
| 定义于头文件 <ranges>
|
||
template< ranges::input_range... Views >
requires (ranges::view<Views> && ...) && (sizeof...(Views) > 0)
class zip_view
: public ranges::view_interface<zip_view<Views...>>
|
(1) | (C++23 起) |
namespace views {
inline constexpr /*unspecified*/ zip = /*unspecified*/;
}
|
(2) | (C++23 起) |
| 调用签名 |
||
template< ranges::viewable_range... Rs >
requires /* see below */
constexpr ranges::view auto zip( Rs&&... rs );
|
(C++23 起) | |
zip_view 是一个范围适配器,它接受一个或多个 view,并生成一个 view,其第 个元素是一个类元组的值,由所有视图的第 i 个元素组成。生成的视图的大小是所有适配视图大小的最小值。i2) 是一个定制点对象。views::zip 表达式等价于 。views::zip()否则, 表达式等价于 。auto(views::empty<std::tuple<>>)views::zip(rs...)expression-equivalent to ranges::zip_view<views::all_t<decltype((rs))>...>(rs...).
zip_view 始终满足 input_range,并且如果所有被适配的 view 类型分别满足 forward_range、bidirectional_range、random_access_range 或 sized_range 概念,则它也满足对应的概念。
zip_view 满足 common_range 当且仅当:
sizeof...(Views)等于1,并且唯一被适配的视图类型满足 common_range,或- 至少有一个被适配的视图类型不满足 bidirectional_range,并且所有被适配的视图类型都满足 common_range,或
- 所有被适配的视图类型同时满足 random_access_range 和 sized_range。
定制点对象
名称
views::zip
表示一个
定制点对象
,它是一个常量
函数对象
,具有
字面量
类型的
semiregular
类类型。有关详细信息,请参阅
定制点对象
。
数据成员
| 成员 | 描述 |
std::
tuple
<
Views...
>
views_
|
所有适配的视图对象
( 仅用于说明的成员对象* ) |
成员函数
构造
zip_view
(公开成员函数) |
|
|
返回指向起始位置的迭代器
(公开成员函数) |
|
|
返回指向末尾位置的迭代器或哨兵
(公开成员函数) |
|
返回元素数量,仅当每个底层(适配的)范围满足
sized_range
时提供
(公开成员函数) |
|
继承自 ranges::view_interface | |
| 返回派生视图是否为空,仅当它满足 sized_range 或 forward_range 时提供( std::ranges::view_interface<D> 的公开成员函数)
| |
(C++23) |
返回到范围起始的常量迭代器 ( std::ranges::view_interface<D> 的公开成员函数)
|
(C++23) |
返回到范围常量迭代器的哨位 ( std::ranges::view_interface<D> 的公开成员函数)
|
| 返回派生视图是否非空,仅当 ranges::empty 适用于它时提供 ( std::ranges::view_interface<D> 的公开成员函数)
| |
| 返回派生视图中的第一个元素,当它满足 forward_range 时提供( std::ranges::view_interface<D> 的公开成员函数)
| |
| 返回派生视图中的最后一个元素,仅当它满足 bidirectional_range 和 common_range 时提供( std::ranges::view_interface<D> 的公开成员函数)
| |
返回派生视图中第 n个元素,仅当它满足 random_access_range 时提供( std::ranges::view_interface<D> 的公开成员函数)
| |
推导指引
嵌套类
|
迭代器类型
( 仅用于说明的成员类模板* ) |
|
当
zip_view
不是
common_range
时使用的哨兵类型
( 仅用于说明的成员类模板* ) |
辅助模板
|
template
<
class
...
Views
>
constexpr
bool
enable_borrowed_range
<
ranges
::
zip_view
<
Views...
>>
=
|
(C++23 起) | |
对
ranges::enable_borrowed_range
的此特化使得
zip_view
在每一个底层视图满足
borrowed_range
时也满足该概念。
备注
| 功能测试 宏 | 值 | 标准 | 功能 |
|---|---|---|---|
__cpp_lib_ranges_zip
|
202110L
|
(C++23) |
ranges::zip_view
,
ranges:: zip_transform_view , ranges:: adjacent_view , ranges:: adjacent_transform_view |
示例
#include <array> #include <iostream> #include <list> #include <ranges> #include <string> #include <tuple> #include <vector> void print(auto const rem, auto const& range) { for (std::cout << rem; auto const& elem : range) std::cout << elem << ' '; std::cout << '\n'; } int main() { auto x = std::vector{1, 2, 3, 4}; auto y = std::list<std::string>{"α", "β", "γ", "δ", "ε"}; auto z = std::array{'A', 'B', 'C', 'D', 'E', 'F'}; print("源视图:", ""); print("x: ", x); print("y: ", y); print("z: ", z); print("\nzip(x,y,z):", ""); for (std::tuple<int&, std::string&, char&> elem : std::views::zip(x, y, z)) { std::cout << std::get<0>(elem) << ' ' << std::get<1>(elem) << ' ' << std::get<2>(elem) << '\n'; std::get<char&>(elem) += ('a' - 'A'); // 修改 z 的元素 } print("\n修改后,z: ", z); }
输出:
源视图: x: 1 2 3 4 y: α β γ δ ε z: A B C D E F zip(x,y,z): 1 α A 2 β B 3 γ C 4 δ D 修改后,z: a b c d E F
参见
由应用于适配视图对应元素的变换函数结果组成的
view
(类模板) (定制点对象) |
|
获取由
tuple-like
值组成的
view
和一个数字N,生成每个元组第N个元素的
view
(类模板) (范围适配器对象) |