std::ranges::split_view<V,Pattern>::split_view - cppreference.com (original) (raw)

Defined in header
split_view() requires std::default_initializable<V> && std::default_initializable<Pattern> = default; (1) (since C++20)
constexpr explicit split_view( V base, Pattern pattern ); (2) (since C++20)
template< ranges::forward_range R > requires std::constructible_from<V, views::all_t<R>> && std::constructible_from<Pattern, ranges::single_view< ranges::range_value_t<R>>> constexpr explicit split_view( R&& r, ranges::range_value_t<R> e ); (3) (since C++20)

Constructs a split_view.

Let _[base](../split%5Fview.html#base "cpp/ranges/split view")_ be the underlying view and _[pattern](../split%5Fview.html#pattern "cpp/ranges/split view")_ be the delimiter.

  1. Default constructor. Value-initializes _base_ and _pattern_ with their default member initializers respectively.

  2. Initializes _base_ with std::move(base) and _pattern_ with std::move(pattern).

[edit] Parameters

base - the view (to be split)
pattern - view to be used as the delimiter
e - element to be used as the delimiter

[edit] Example

#include #include #include #include #include #include #include #include   int main() { { auto view = std::views::iota(1, 20) | std::views::transform([](int x) { return x % 5; }); auto splits = std::views::split(view, 0); // (2) for (const auto& split : splits) { std::cout << "{ "; std::ranges::copy(split, std::ostream_iterator(std::cout, " ")); std::cout << "} "; } } std::cout << '\n';   { const std::vector nums{1, -1, -1, 2, 3, -1, -1, 4, 5, 6}; const std::array delim{-1, -1}; auto splitter = std::views::split(nums, delim); // (3) for (const auto& split : splitter) { std::cout << "{ "; std::ranges::copy(split, std::ostream_iterator(std::cout, " ")); std::cout << "} "; } } std::cout << '\n';   { constexpr std::string_view JupiterMoons { "Callisto, Europa, Ganymede, Io, and 91 more" }; constexpr std::string_view delim{", "}; std::ranges::split_view moons_extractor{JupiterMoons, delim}; // (3) auto is_moon = std::views::filter([](auto str) { return std::isupper(str[0]); }); std::cout << "Some moons of Jupiter: "; for (const auto moon : moons_extractor | is_moon) std::cout << std::string_view(moon) << ' '; } std::cout << '\n'; }

Output:

{ 1 2 3 4 } { 1 2 3 4 } { 1 2 3 4 } { 1 2 3 4 } { 1 } { 2 3 } { 4 5 6 } Some moons of Jupiter: Callisto Europa Ganymede Io

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR Applied to Behavior as published Correct behavior
LWG 3714(P2711R1) C++20 the multi-parameter constructor was not explicit made explicit

[edit] See also

| | constructs a lazy_split_view (public member function of std::ranges::lazy_split_view<V,Pattern>) [edit] | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |