Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::views::split — podział zakresu na podzakresy

std::views::split tworzy widok fragmentów rozdzielonych elementem lub wzorcem. Fragmenty odwołują się do danych źródłowych zamiast tworzyć osobne napisy; sąsiednie i końcowe separatory mogą dawać puste fragmenty.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <ranges>
std::views::split(range, delimiter)
range | std::views::split(delimiter)

std::views::split z nagłówka <ranges> jest adaptorem tworzącym std::ranges::split_view. Dla zakresu znaków i separatora takiego jak ',' wywołanie bezpośrednie std::views::split(range, delimiter) i zapis potokowy range | std::views::split(delimiter) dają ten sam podział. Nie można jednak używać obu form zamiennie, gdy separatorem jest tablica. Separator jest pojedynczym elementem albo zakresem stanowiącym cały wzorzec, nie zbiorem alternatywnych separatorów.

Zakres źródłowy i wzorzec muszą spełniać wymagania forward_range, a ich elementy muszą być porównywalne. Wyszukiwanie odbywa się podczas iteracji, bez tworzenia kolekcji napisów. Każdy fragment jest obiektem std::ranges::subrange z iteratorami do danych źródłowych; separator nie należy do fragmentu.

Sąsiednie separatory tworzą puste fragmenty, podobnie jak separator na końcu. Puste wejście nie daje żadnych fragmentów. W wywołaniu bezpośrednim literał "::" służy jako wzorzec tablicowy obejmujący także końcowy znak zerowy. W zapisie potokowym częściowe zastosowanie adaptora powoduje konwersję tablicy na wskaźnik const char*, który nie jest ani zakresem stanowiącym wzorzec, ani separatorem znakowym. Aby rozdzielać po :: bez znaku zerowego, użyj std::string_view{"::"} w dowolnej z obu form.

Przy pożyczonych danych zadbaj o ich czas życia i nie unieważniaj iteratorów podczas używania widoku ani fragmentów. Przykład korzysta z literału o statycznym czasie życia i wypisuje puste fragmenty jako []. Ustawienie C++23 jest celem kompilacji, nie potwierdzeniem działania w środowisku produkcyjnym.

Przykłady

#include <iostream>
#include <ranges>
#include <string_view>

int main() {
    constexpr std::string_view text = "red,,blue,";
    for (auto part : text | std::views::split(',')) {
        std::cout << '[';
        for (char c : part) {
            std::cout << c;
        }
        std::cout << "]\n";
    }
}

Wynik

[red]
[]
[blue]
[]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła