std::ranges:: views::split, std::ranges::

split_view models the concepts forward_range, and common_range when the underlying view V

The inner range (ranges::range_reference_t<split_view>) is a ranges::subrange < ranges::iterator_t <V>> , which models common_range, models sized_range when ranges::iterator_t<V> models std::sized_sentinel_for < ranges::iterator_t <V>> , and models contiguous_range, random_access_range, bidirectional_range, and forward_range when V

Unlike lazy_split_view, split_view maintains the continuity of the subrange, making it suitable for string splitting.

Data members

Member functions

Nested classes

Deduction guides

Notes

Before P2210R2, split_view used a lazy P2210R2, and the lazy mechanism is moved to lazy_split_view

The delimiter pattern generally should not be an ordinary string literal, as it will consider the null terminator to be necessary part of the delimiter; therefore, it is advisable to use a std::string_view

Example

#include <iomanip>
#include <iostream>
#include <ranges>
#include <string_view>
 
int main()
{
    using std::operator""sv;
    constexpr auto words{"Hello^_^C++^_^20^_^!"sv};
    constexpr auto delim{"^_^"sv};
 
    for (const auto word : std::views::split(words, delim))
        // with string_view's C++23 range constructor:
        std::cout << std::quoted(std::string_view(word)) << ' ';
    std::cout << '\n';
}

"Hello" "C++" "20" "!"

Defect reports

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

See also