Classe filter_view (Biblioteca Padrão C++)

Uma exibição que filtra os elementos de um intervalo que não correspondem ao predicado.

Sintaxe

template<ranges::input_range V, indirect_unary_predicate<iterator_t<V>> Pred>
    requires view<V> && is_object_v<Pred>
class filter_view : public view_interface<filter_view<V, Pred>>;

Parâmetros de modelo

V
O tipo do intervalo subjacente.

Pred
O tipo do predicado que determina quais elementos manter.

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::filter
Intervalo subjacente	Deve satisfazer input_range ou superior
Tipo de elemento	O mesmo que o intervalo subjacente
Exibir categoria do iterador	input_range, forward_rangeou bidirectional_range dependendo do intervalo subjacente
Tamanho	Não
É 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
ConstrutoresC++20	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.
predC++20	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.
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 filter_view

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

Parâmetros

base
A visão subjacente.

pred
O predicado que determina quais elementos manter da exibição subjacente.

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

Valor retornado

Uma instância de filter_view.

Comentários

A melhor maneira de criar um filter_view é usando o adaptador de views::filter 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) Crie um arquivo filter_view. O predicado e a exibição subjacente devem ser inicializáveis por padrão.
2) Move constrói a filter_view partir de uma base visualização e um pred predicado. Ambos base e pred são movidos via std::move().

Exemplo: filter_view

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

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::filter(v, [](int i) {return i > 0; });
    print(myView); // outputs 1 3 6

    auto myView2 = v | std::views::filter([](int i) {return i < 3; });
    print(myView2); // outputs 0 1 -2 -4 -5
}

1 3 6
0 1 -2 -4 -5

base

Obtém o intervalo subjacente.

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

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

end

Pegue a sentinela no final da vista.

constexpr auto end()

Valor retornado

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

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 classe 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::filter(
        [](int i) {return i < 5; }); // keep the 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)
}

Confira também

<ranges>
filter adaptador de gama
drop_while()
take_while()
Ver aulas