| ||||||||||||||||||||||
| Range primitives | |||||||
| |||||||
| Range concepts | |||||||||||||||||||
| |||||||||||||||||||
| Range factories | |||||||||
| |||||||||
| Range adaptors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Helper items | |||||||||||||||||
| |||||||||||||||||
Defined in header <ranges> | ||
template<ranges::input_range V> requiresranges::view<V> and | (1) | (since C++20) |
namespace views{ inlineconstexpr/* unspecified */ join=/* unspecified */; | (2) | (since C++20) |
Call signature | ||
template<ranges::viewable_range R> requires/* see below */ | (since C++20) | |
view consisting of the sequence obtained from flattening a view of ranges.join_view modelsinput_range.
join_view modelsforward_range when:
forward_range.join_view modelsbidirectional_range when:
bidirectional_range, andbidirectional_range andcommon_range.join_view modelscommon_range when:
forward_range andcommon_range.Contents |
constructs ajoin_view(public member function)[edit] | |
| returns a copy of the underlying (adapted) view (public member function)[edit] | |
| returns an iterator to the beginning (public member function)[edit] | |
| returns an iterator or a sentinel to the end (public member function)[edit] | |
Inherited fromstd::ranges::view_interface | |
returns whether the derived view is empty, provided only if it satisfiessized_range orforward_range(public member function of std::ranges::view_interface<D>)[edit] | |
(C++23) | returns a constant iterator to the beginning of the range (public member function of std::ranges::view_interface<D>)[edit] |
(C++23) | returns a sentinel for the constant iterator of the range (public member function of std::ranges::view_interface<D>)[edit] |
| returns whether the derived view is not empty, provided only ifranges::empty is applicable to it (public member function of std::ranges::view_interface<D>)[edit] | |
returns the first element in the derived view, provided if it satisfiesforward_range(public member function of std::ranges::view_interface<D>)[edit] | |
returns the last element in the derived view, provided only if it satisfiesbidirectional_range andcommon_range(public member function of std::ranges::view_interface<D>)[edit] | |
| the iterator type (exposition-only member class template*) | |
| the sentinel type (exposition-only member class template*) |
BeforeP2328R1 was adopted, the inner range type (ranges::range_reference_t<V>) cannot be a container type (but can be reference to container). For example, it was not allowed to join atransform_view ofstd::string prvalue.
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 P2328R1return 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(){usingnamespace std::literals; constauto bits={"https:"sv,"//"sv,"cppreference"sv,"."sv,"com"sv};for(charconst c: bits| std::views::join)std::cout<< c;std::cout<<'\n'; conststd::vector<std::vector<int>> v{{1,2},{3,4,5},{6},{7,8,9}};auto jv= std::ranges::join_view(v);for(intconst e: jv)std::cout<< e<<' ';std::cout<<'\n';}
Output:
https://cppreference.com1 2 3 4 5 6 7 8 9
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3474 | C++20 | views::join(e) returned a copy ofe whene is ajoin_view | returns a nestedjoin_view |
| P2328R1 | C++20 | non-viewrange prvalues could not be joined byjoin_view | made joinable |
aview consisting of the sequence obtained from flattening a view of ranges, with the delimiter in between elements(class template)(range adaptor object)[edit] | |
aview consisting of concatenation of the adapted views(class template)(customization point object)[edit] |