Partilhar via


Classe join_view (Biblioteca Padrão C++)

Combina os elementos de um intervalo de intervalos em uma única visualização.

Sintaxe

template<input_range R> requires view<R> && input_range<range_reference_t<R>> &&
    (is_reference_v<range_reference_t<R>> || view<range_value_t<R>>)
class join_view : public view_interface<join_view<R>>;

Parâmetros de modelo

R
O tipo do intervalo subjacente. Deve satisfazer input_range ou superior.

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::join
Intervalo subjacente Deve satisfazer input_range ou superior
Tipo de elemento O mesmo que o intervalo subjacente
Exibir categoria do iterador input_range até dependendo bidirectional_range do intervalo subjacente que está sendo iterado
Tamanho Não
É const-iterável Somente se o intervalo subjacente for const iterável
Faixa comum Somente se o intervalo subjacente satisfizer common_range
Alcance emprestado Não

Membros

Funções de membro Descrição
ConstrutoresC++20 Constrói um join_view.
baseC++20 Obtenha uma referência ao 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
backC++20 Obtenha o último elemento.
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.

Comentários

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

Essa exibição é útil quando você deseja combinar vários intervalos em uma única exibição.

Requisitos

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

Namespace: std::ranges

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

Construtores

Crie uma instância de uma join_view.

1) join_view() = default;
2) constexpr explicit join_view(R base)

Parâmetros

base
O intervalo subjacente.

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

Comentários

1) Construções padrão de um join_view.
2) Constrói o join_view de base.

Exemplo: join_view

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

int main()
{
    std::vector<int> rg1{1, 2, 3, 4};
    std::vector<int> rg2{5, 6, 7};
    std::vector<int> rg3{8, 9, 10, 11, 12, 13};
    std::vector<int> rangeOfRanges[] {rg1, rg2, rg3};

    auto jv = std::ranges::join_view(rangeOfRanges);

    for (auto& e : jv)
    {
        std::cout << e << " ";
    }
}
1 2 3 4 5 6 7 8 9 10 11 12 13

base

Obtenha a visã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.

Valor retornado

  1. A exibição retornada é construída por cópia.
  2. A exibição retornada é construída por movimento.

begin

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

constexpr auto begin();
constexpr auto begin() const
    requires ranges::input_range<const V> && std::is_reference_v<ranges::range_reference_t<const V>>;

Parâmetros

Nenhum.

Valor retornado

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

Imagem de um vetor com os elementos 10, 20 e 30. O primeiro elemento contém 10 e é rotulado begin(). O último elemento contém 30 e é rotulado como 'último elemento'. Uma caixa imaginária após o último elemento indica o sentinela e é rotulada como end().

end

Pegue a sentinela no final da vista.

constexpr sentinel_t<R> end();
constexpr auto end() const requires range<const R>

Parâmetros

Nenhum.

Valor retornado

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

Imagem de um vetor com os elementos 10, 20 e 30. O primeiro elemento contém 10 e é rotulado begin(). O último elemento contém 30 e é rotulado como 'último elemento'. Uma caixa imaginária após o último elemento indica o sentinela e é rotulada como end().

Confira também

join adaptador de gama
<ranges>
Ver aulas