std::ranges::split_view<V,Pattern>::split_view

 

C++

Compiler support

Freestanding and hosted

Language

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Technical specifications

Symbols index

External libraries

 

Ranges library

Range access
begin cbegin end cend	rbegin crbegin rend crend	size ssize data cdata	empty
Range primitives
iterator_tsentinel_t	range_size_trange_difference_t	range_reference_trange_rvalue_reference_t	range_value_t
Dangling iterator handling
dangling	borrowed_iterator_t	borrowed_subrange_t
Range concepts
range borrowed_range    sized_range	common_range view viewable_range	input_range output_range forward_range	bidirectional_range random_access_range contiguous_range
Views
view_interface	subrange
Factories
empty_viewviews::empty	single_viewviews::single	iota_viewviews::iota	basic_istream_viewviews::istream
Adaptors
views::all_tviews::all ref_view owning_view common_viewviews::common reverse_viewviews::reverse views::counted zip_viewviews::zip (C++23)(C++23)	take_viewviews::take take_while_viewviews::take_while drop_viewviews::drop drop_while_viewviews::drop_while zip_transform_viewviews::zip_transform (C++23)(C++23)	elements_viewviews::elements keys_viewviews::keys values_viewviews::values transform_viewviews::transform adjacent_viewviews::adjacent (C++23)(C++23)	filter_viewviews::filter join_viewviews::join split_viewviews::split lazy_split_viewviews::lazy_split adjacent_transform_viewviews::adjacent_transform (C++23)(C++23)
Range adaptor objects
Range adaptor closure objects
Helper items
copyable-box	simple-view

 

std::ranges::split_view

Member functions

split_view::split_view (C++20)

split_view::base (C++20)

split_view::begin (C++20)

split_view::end (C++20)

Nested classes

split_view::iterator (C++20)

split_view::sentinel (C++20)

Deduction guides

 

split_view()   requires std::default_initializable<V> &&            std::default_initializable<Pattern> = default;	(1)	(since C++20)
constexpr 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 split_view( R&& r, ranges::range_value_t<R> e );	(3)	(since C++20)

Constructs a split_view.

Let base_ be the underlying view and pattern_ be the delimiter.

1) Default constructor. Value-initializes the base_ and the pattern_ with their default member initializers respectively.

2) Initializes the base_ with std::move(base) and the pattern_ with std::move(pattern).

3) Initializes the base_ with views::all(std::forward<R>(r)) and the pattern_ with ranges::single_view{std::move(e)}.

Parameters

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

Example

A link to check the code: wandbox

Run this code

#include <string_view>
#include <algorithm>
#include <iterator>
#include <iostream>
#include <iomanip>
#include <ranges>
#include <vector>
#include <array>
 
int main()
{
    {
        auto view = std::views::iota(1, 20)
                  | std::views::transform([](int x) { return x % 5; });
        auto splitts = std::views::split(view, 0); // (2)
        for (const auto& split : splitts) {
            std::cout << "{ ";
            std::ranges::copy(split, std::ostream_iterator<int>(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<int>(std::cout, " "));
            std::cout << "} ";
        }
    }
    std::cout << '\n';
    {
        constexpr std::string_view JupiterMoons{"Callisto, Europa, Ganymede, Io, and 75 more"};
        constexpr std::string_view delim{", "};
        std::ranges::split_view moons_extractor{ JupiterMoons, delim }; // (3)
        for (const std::string_view moon : moons_extractor) {
            std::cout << std::quoted(moon) << ' ';
        }
    }
}

Output:

{ 1 2 3 4 } { 1 2 3 4 } { 1 2 3 4 } { 1 2 3 4 }
{ 1 } { 2 3 } { 4 5 6 }
"Callisto" "Europa" "Ganymede" "Io" "and 75 more"

See also

(constructor) (C++20)

constructs a lazy_split_view (public member function of std::ranges::lazy_split_view<V,Pattern>)