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. |
base C++20 |
Obtenha o intervalo subjacente. |
begin C++20 |
Obtenha um iterador para o primeiro elemento. |
end C++20 |
Pegue a sentinela no final da vista. |
Herdado de view_interface |
Descrição |
empty C++20 |
Teste se a exibição está vazia. |
front C++20 |
Obtenha o primeiro elemento. |
operator bool C++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