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. |
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. |
pred C++20 |
Obtenha uma referência ao predicado que determina quais elementos tomar. |
Herdado de view_interface |
Descrição |
back C++20 |
Obtenha o último elemento. |
data C++20 |
Obtenha um ponteiro para o primeiro elemento. |
empty C++20 |
Teste se a exibição está vazia. |
front C++20 |
Obtenha o primeiro elemento. |
operator[] C++20 |
Obter o elemento na posição especificada. |
operator bool C++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)
}