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++.

Смотрите также