Classe take_while_view (Biblioteca Padrão C++)

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

Sintaxe

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

Parâmetros de modelo

Pred
O tipo do predicado que determina os elementos principais a serem colocados na exibição.

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::take_while
Intervalo subjacente	Deve satisfazer input_range ou superior
Tipo de elemento	O mesmo que o intervalo subjacente
Exibir categoria do iterador	O mesmo que o intervalo subjacente
Tamanho	Não
É const-iterável	Somente se o intervalo subjacente for const iterável e o predicado puder trabalhar com const referências.
Faixa comum	Não
Alcance emprestado	Não

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 tomar.
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

Construir uma instância de um take_while_view

1) take_while_view() requires 
    default_initializable<V> &&
    default_initializable<Pred> = default;

2) constexpr take_while_view(V base, Pred pred);

Parâmetros

base
A visão subjacente.

pred
O predicado que determina os elementos principais a serem colocados na exibição.

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

Valor retornado

Um objeto take_while_view.

Comentários

A melhor maneira de criar um take_while_view é usando o adaptador de views::take_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 take_while_view partir de uma base visualização e um pred predicado. Ambos base e pred são movidos via std::move().
2) Constrói um arquivo .take_while_view A exibição subjacente e o predicado são construídos por padrão.

Exemplo: take_while_view

// 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 twv = std::views::take_while(v, [](int i) {return i >= 0; });
    
    for (auto& e : twv)
    {
        std::cout << e << ' '; // 0 1 2 3
    }
    std::cout << '\n';

    // Using the '|' operator to create a take_view
    for (auto i : v | std::views::take_while([](int i) {return i < 5; }))
    {
        std::cout << i << ' '; // 0 1 2 3 -4
    }
}

0 1 2 3
0 1 2 3 -4

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

Uma cópia da exibição subjacente.

begin

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

1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires
        range<const V> && 
        indirect_unary_predicate<const Pred, iterator_t<const V>>

Parâmetros

Nenhum.

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.

Comentários

Para 1, o Simple_view requisito significa que uma exibição V e const V têm os mesmos tipos de iterador e sentinela.

end

Pegue a sentinela no final da vista.

1) constexpr auto end() requires (!Simple_view<V>);
2) constexpr auto end() const requires
        range<const V> &&
        indirect_unary_predicate<const Pred, iterator_t<const V>

Parâmetros

Nenhum.

Valor retornado

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

Comentários

Para 1, o Simple_view requisito significa que uma exibição V e const V têm os mesmos tipos de iterador e sentinela.

pred

Obtenha uma referência ao predicado usado para selecionar quais elementos principais irão na exibição.

constexpr const Pred& pred() const;

Valor retornado

Uma referência ao predicado usado para selecionar os elementos principais a serem colocados na exibição.

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::take_while(
        [](int i) {return i < 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>
take_view
take_while adaptador de gama
Ver aulas