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

template< ranges::forward_range V, ranges::forward_range Pattern >
requires ranges::view<V> &&
         ranges::view<Pattern> &&
         std::indirectly_comparable<ranges::iterator_t<V>,
                                    ranges::iterator_t<Pattern>,
                                    ranges::equal_to>
class split_view
    : public ranges::view_interface<split_view<V, Pattern>>

namespace views {
    inline constexpr /* unspecified */ split = /* unspecified */;
}

template< ranges::viewable_range R, class Pattern >
    requires /* see below */
constexpr ranges::view auto split( R&& r, Pattern&& pattern );

template< class Pattern >
constexpr /* range adaptor closure */ split( Pattern&& pattern );

split_view удовлетворяет концепциям forward_range и common_range, если лежащий в основе view V удовлетворяет соответствующим концепциям.

Внутренний диапазон (ranges::range_reference_t<split_view>) — это ranges::subrange<ranges::iterator_t<V>>, который удовлетворяет концепции common_range, концепции sized_range, если ranges::iterator_t<V> удовлетворяет std::sized_sentinel_for<ranges::iterator_t<V>>, и концепциям contiguous_range, random_access_range, bidirectional_range и forward_range, если V удовлетворяет соответствующим концепциям.

В отличие от lazy_split_view, split_view сохраняет непрерывность поддиапазона, что делает его подходящим для разделения строк.

Поля данных

Функции-члены

Вложенные классы

Руководства по выводу типов

Примечания

До выхода P2210R2 в split_view для разбиения использовался ленивый механизм, поэтому не удавалось сохранить свойства двунаправленного, произвольного доступа или непрерывного диапазона, присущие лежащему в основе представлению, а также обеспечить совпадение типа итератора внутреннего диапазона с типом итератора лежащего в основе представления. В результате в P2210R2 он был переработан, а ленивый механизм перенесён в lazy_split_view.

В качестве разделителя pattern обычно не следует использовать обычный строковый литерал, поскольку завершающий нулевой символ будет считаться обязательной частью разделителя; поэтому вместо него рекомендуется использовать литерал std::string_view.

Пример

#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" "!"

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

См. также