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 modelliert die Konzepte forward_range, und common_range, wenn die zugrundeliegende view V die entsprechenden Konzepte modelliert.

Der innere Bereich (ranges::range_reference_t<split_view>) ist eine ranges::subrange<ranges::iterator_t<V>>, die common_range modelliert, sized_range modelliert, wenn ranges::iterator_t<V> std::sized_sentinel_for<ranges::iterator_t<V>> modelliert, und contiguous_range, random_access_range, bidirectional_range und forward_range modelliert, wenn V die entsprechenden Konzepte modelliert.

Im Gegensatz zu lazy_split_view bewahrt split_view die Kontinuität des Unterbereichs, was ihn für die Zeichenkettenaufteilung geeignet macht.

Datenmitglieder

Memberfunktionen

Geschachtelte Klassen

Deduktionshilfen

Hinweise

Vor P2210R2 verwendete split_view einen lazy -Mechanismus für die Aufteilung und konnte daher die bidirektionalen, wahlfreien Zugriffs- oder zusammenhängenden Eigenschaften der zugrunde liegenden Ansicht nicht beibehalten oder den Iteratortyp des inneren Bereichs gleich dem der zugrunde liegenden Ansicht machen. Daher wurde es von P2210R2 neu gestaltet, und der lazy-Mechanismus wurde zu lazy_split_view verschoben.

Das Trennzeichen pattern sollte generell kein gewöhnlicher String-Literal sein, da es den Null-Terminator als notwendigen Teil des Trennzeichens betrachten wird; daher ist es ratsam, stattdessen einen std::string_view -Literal zu verwenden.

Beispiel

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

` und `` Tags (C++ Code)
- C++ spezifische Begriffe und Syntax
- Kommentare im Code (wie "// with string_view's C++23 range constructor:")
- Ausgabetext im Output-Bereich

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch