Compartilhar via

Classe drop_while_view (Biblioteca Padrão C++)

Uma exibição que contém os elementos de um intervalo que permanecem depois que os elementos principais que correspondem a um predicado são descartados.

Sintaxe

template<ranges::view V, class P>
    requires ranges::input_range<V> &&
             std::is_object_v<P> &&
             std::indirect_unary_predicate<const P, ranges::iterator_t<V>>
class drop_while_view : public ranges::view_interface<drop_while_view<V, P>>;

Parâmetros de modelo

V
O tipo da exibição subjacente.

P
O tipo do predicado que determina os elementos principais a serem descartados.

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::drop_while
Intervalo subjacente Deve satisfazer forward_range ou superior e os iteradores do intervalo subjacente devem modelar sized_sentinel_for
Tipo de elemento O mesmo que o intervalo subjacente
Exibir categoria do iterador O mesmo que o intervalo subjacente
Tamanho Somente se o intervalo subjacente satisfizer random_access_range
É const-iterável Não
Faixa comum Somente se o intervalo subjacente satisfizer common_range
Alcance emprestado Somente se o intervalo subjacente satisfizer borrowed_range

Membros

Funções de membro Descrição
Construtores Construa a exibição.
base Obtenha a visão subjacente.
begin Obtenha um iterador para o primeiro elemento.
end Pegue a sentinela no final da vista.
pred Obtenha uma referência ao predicado que determina quais elementos devem ser descartados.
Herdado de view_interface Descrição
backC++20 Obtenha o último elemento.
dataC++20 Obtenha um ponteiro para o primeiro elemento.
emptyC++20 Teste se a exibição está vazia.
frontC++20 Obtenha o primeiro elemento.
operator[]C++20 Obter o elemento na posição especificada.
operator boolC++20 Teste se a exibição não está vazia.
size Obtenha o número de elementos na exibição.

Requisitos

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

Namespace: std::ranges

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

Construtores

Construa uma instância de um drop_while_viewarquivo .

1) constexpr drop_while_view(V base, P pred);
2) drop_while_view() requires default_initializable<V> && default_initializable<P> = default;

Parâmetros

base
O intervalo subjacente.

pred
O predicado que determina os elementos principais a serem descartados.

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

Valor retornado

Uma instância de drop_while_view.

Comentários

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

1) Move constrói a drop_while_view partir de uma base visualização e um pred predicado. Ambos base e pred são movidos via std::move().
2) Construções padrão a .drop_while_view

Exemplo: drop_while_view

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

void print(auto v)
{
    for (auto& x : v)
    {
        std::cout << x << ' ';
    }
    std::cout << '\n';
}

int main()
{
    std::vector<int> v{ 0, 1, 2, 3, -4, 5, 6 };
    auto myView = std::views::drop_while(
        v,
        [](int i) {return i >= 0; });
    print(myView); // -4 5 6

    auto myView2 = v | std::views::drop_while(
        [](int i) {return i < 5; });
    print(myView2); // 5 6
}

-4 5 6
5 6

base

Obtenha a visão subjacente.

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

// Uses std::move() to return the underlying view
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();

Valor retornado

Um iterador apontando para o primeiro elemento na exibição. O comportamento será indefinido se a exibição não tiver um predicado.

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 auto end()

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().

pred

Obtenha uma referência ao predicado que determina quais elementos principais devem ser descartados.

constexpr const Pred& pred() const;

Valor retornado

Uma referência ao predicado.

Comentários

Se a exibição não armazenar um predicado, o comportamento será indefinido.

Exemplo pred

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

int main()
{
    std::vector<int> v{ 0, 1, 2, 3, -4, 5, 6 };
    auto mv = v | std::views::drop_while(
        [](int i) {return i < 5; }); // drop the leading elements < 5
    std::cout << std::boolalpha << mv.pred()(v[6]); // outputs "false" because v[6] = 6 and 6 is not less than 5 (the predicate)
}

false

Confira também

<ranges>
drop_while adaptador de gama
take_while adaptador de gama
take_while_view
Ver aulas

  • Last updated on