Classe split_view (Biblioteca Padrão C++)

Divide uma exibição em subintervalos com base em um delimitador. O delimitador pode ser um único elemento ou uma visualização de elementos. O delimitador não faz parte do .split_view

Uma exibição relacionada é a lazy_split_view classe. As principais diferenças entre split_view e lazy_split_view são:

Exibir	Pode dividir um const intervalo	Tipo de intervalo
split_view	não	Suportes forward_range ou superior.
lazy_split_view	sim	Suportes input_range ou superior.

Prefira split_view porque é mais eficiente, a menos que você precise dividir um intervalo que seja const.

Sintaxe

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

Parâmetros de modelo

Pattern
O tipo de exibição que especifica a sequência do delimitador.

V
O tipo da exibição subjacente.

Ver características

Para obter uma descrição das entradas a seguir, consulte Exibir características da classe

Característica	Descrição
Adaptador de gama	views::split
Intervalo subjacente	O mesmo que o intervalo subjacente
Tipo de elemento	range_reference_t<V>
Exibir categoria do iterador	Satisfaz forward_range
Tamanho	Não
É const-iterável	Não
Faixa comum	Somente se o intervalo subjacente satisfizer common_range
Alcance emprestado	Não

Membros

Funções de membro	Descrição
Construtores	Construa a exibição.
baseC++20	Obtenha o intervalo subjacente.
beginC++20	Obtenha um iterador para o primeiro elemento.
endC++20	Pegue a sentinela no final da vista.
Herdado de view_interface	Descrição
emptyC++20	Teste se a exibição está vazia.
frontC++20	Obtenha o primeiro elemento.
operator boolC++20	Teste se a exibição não está vazia.

Requisitos

Cabeçalho: <ranges> (desde C++20)

Namespace: std::ranges

Opção do compilador: /std:c++20 ou posterior é necessária.

Construtores

Construir uma instância de um split_view

1) split_view() requires default_initializable<V> && default_initializable<Pattern> = default;
2) constexpr split_view(V base, Pattern pattern);
3) template<input_range R> requires constructible_from<V, views::all_t<R>> &&
     constructible_from<Pattern, single_view<range_value_t<R>>>
     constexpr split_view(R&& rg, range_value_t<R> e);

Parâmetros

e
Um único elemento que identifica onde dividir a exibição. O elemento não faz parte da exibição resultante.

base
A visão subjacente.

pattern
A exibição de elementos que identifica onde dividir a exibição. A exibição de elementos não faz parte da exibição resultante.

rg
O intervalo a ser dividido.

Para obter informações sobre tipos de parâmetro de modelo, consulte Parâmetros de modelo.

Valor retornado

Uma split_view instância que contém um ou mais subintervalos.

Comentários

A melhor maneira de criar um split_view é usando o adaptador de views::split intervalo. Os adaptadores de intervalo são a maneira pretendida de criar classes de exibição. Os tipos de exibição são expostos apenas caso você queira criar seu próprio tipo de exibição personalizado.

1) Crie um split_view que seja construído por padrão. A exibição subjacente e pattern são construídos por padrão. base() retorna uma cópia do V().
2) Crie um split_view dividindo a visualização usando uma sequência de delimitadores.
3) Crie um split_view dividindo a visualização usando um único delimitador.

Exemplo split_view

// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>

int main()
{
    std::vector<int> rg{ 1, 2, 3, 1, 2, 3, 4, 5, 6 };

    // pipe syntax using range adaptor
    for (const auto& subrange : rg | std::views::split(3))
    {
        // outputs
        // 1 2
        // 1 2
        // 4 5 6
        for (const auto& elem : subrange)
        {
            std::cout << elem << ' ';
        }
        std::cout << '\n';
    }
    
    int delimiters[] = {2, 3};
    for (auto splitRange : std::views::split(rg, delimiters)) // ctor syntax
    {
        for (auto& i : splitRange)
        {
            std::cout << i << " "; // 1 1 4 5 6
        }
    }
}

1 2
1 2
4 5 6
1 1 4 5 6

base

Obtém uma cópia da exibição subjacente.

// Uses a copy constructor to return the underlying view
1) constexpr V base() const & requires std::copy_constructible<V>;

// Uses a move constructor to return the underlying view
2) constexpr V base() &&;

Parâmetros

Nenhum.

Devoluções

A visão subjacente.

begin

Obtenha um iterador para o primeiro elemento na exibição.

constexpr auto begin();

Parâmetros

Nenhum.

Valor retornado

Um iterador apontando para o primeiro elemento na exibição.

end

Pegue a sentinela no final da vista.

constexpr auto end();

Parâmetros

Nenhum.

Valor retornado

A sentinela que segue o último elemento na exibição:

Confira também

<ranges>
split_view adaptador de gama
lazy_split_view classe
Ver aulas