std::ranges::views::join,std::ranges::join_view
来自 cppreference.com
定义在头文件 <ranges> 中 |
||
template< ranges::input_range V > requires ranges::view<V> and |
(1) | (自 C++20) |
namespace views { inline constexpr /* 未指定 */ join = /* 未指定 */; |
(2) | (自 C++20) |
调用签名 |
||
template< ranges::viewable_range R > requires /* 参见下文 */ |
(自 C++20) | |
1) 一个范围适配器,它表示一个由扁平化的范围视图得到的序列组成的
view
。2) RangeAdaptorObject(也是 RangeAdaptorClosureObject)。表达式 views::join(e) 与 join_view<views::all_t<decltype((e))>>{e} 对于任何合适的子表达式 e 是 表达式等效的。
join_view
模拟 input_range
。
join_view
模拟 forward_range
,当
- ranges::range_reference_t<V> 是一个引用类型时,并且
- V 和 ranges::range_reference_t<V> 都模拟
forward_range
。
join_view
模拟 bidirectional_range
,当
- ranges::range_reference_t<V> 是一个引用类型时,
- V 模拟
bidirectional_range
,并且 - ranges::range_reference_t<V> 模拟
bidirectional_range
和common_range
。
join_view
模拟 common_range
,当
- ranges::range_reference_t<V> 是一个引用类型时,并且
- V 和 ranges::range_reference_t<V> 都模拟
forward_range
和common_range
。
内容 |
[编辑] 成员函数
构造一个 join_view (公共成员函数) | |
返回底层(适配)视图的副本 (公共成员函数) | |
返回指向开头的迭代器 (公共成员函数) | |
返回指向结尾的迭代器或哨兵 (公有成员函数) | |
继承自 std::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> 的公有成员函数) |
[编辑] 推导指南
[编辑] 嵌套类
迭代器类型 (仅供说明的成员类模板*) | |
哨兵类型 (仅供说明的成员类模板*) |
[编辑] 注释
在采用 P2328R1 之前,内部范围类型 (ranges::range_reference_t<V>) 不能是容器类型(但可以是容器的引用)。例如,不允许连接 transform_view
的 std::string 右值。
struct Person { int age; std::string name; }; auto f(std::vector<Person>& v) { // return v | std::views::transform([](auto& p){ return p.name; }) // | std::views::join; // error before P2328R1 return v | std::views::transform([](auto& p) -> std::string& { return p.name; }) | std::views::join; // OK }
[编辑] 示例
运行此代码
#include <iostream> #include <ranges> #include <string_view> #include <vector> int main() { using namespace std::literals; const auto bits = {"https:"sv, "//"sv, "cppreference"sv, "."sv, "com"sv}; for (char const c : bits | std::views::join) std::cout << c; std::cout << '\n'; const std::vector<std::vector<int>> v{{1, 2}, {3, 4, 5}, {6}, {7, 8, 9}}; auto jv = std::ranges::join_view(v); for (int const e : jv) std::cout << e << ' '; std::cout << '\n'; }
输出
https://cppreference.com 1 2 3 4 5 6 7 8 9
[编辑] 缺陷报告
以下行为更改缺陷报告已追溯应用于先前发布的 C++ 标准。
DR | 应用于 | 已发布的行为 | 正确行为 |
---|---|---|---|
LWG 3474 | C++20 | views::join(e) 返回 e 的副本,当 e 是 join_view 时 |
返回嵌套的 join_view |
P2328R1 | C++20 | 非视图 range 右值不能被 join_view 连接 |
已连接 |
[编辑] 另请参阅
一个由扁平化范围视图获得的序列组成的 view ,元素之间有分隔符(类模板) (范围适配器对象) | |
一个由适配视图的串联组成的 view (类模板) (定制点对象) |