Classe elements_view (Biblioteca Padrão C++)
Uma exibição sobre os elementos em um índice selecionado em cada valor semelhante a uma tupla em um intervalo. Por exemplo, dado um intervalo de std::tuple<string, int>, crie uma exibição que consiste nos string elementos de cada tupla.
Sintaxe
template<input_range V, size_t N>
class elements_view : public view_interface<elements_view<V, N>>;
Parâmetros de modelo
N
O índice do elemento a ser selecionado para a exibição.
V
O tipo do intervalo subjacente. Este tipo deve satisfazer ranges::input_range.
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::elements |
| Intervalo subjacente | Deve satisfazer input_range ou superior |
| Tipo de elemento | O mesmo que o tipo do elemento de tupla indexado |
| Exibir categoria do iterador | forward_range, bidirectional_range ou random_access_range |
| Tamanho | Somente se o intervalo subjacente satisfizer sized_range |
É const-iterável |
Somente se o intervalo subjacente satisfizer const-iterable |
| 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 um elements_view. |
baseC++20 |
Obtenha o intervalo subjacente. |
beginC++20 |
Obtenha um iterador para o primeiro elemento. |
endC++20 |
Pegue a sentinela no final da vista. |
sizeC++20 |
Obtenha o número de elementos nesta visualização. O intervalo subjacente deve satisfazer sized_range. |
Herdado de view_interface |
Descrição |
backC++20 |
Obtenha o último elemento. |
emptyC++20 |
Testar se o elements_view está vazio. |
frontC++20 |
Obtenha o primeiro elemento. |
operator[]C++20 |
Obter o elemento na posição especificada. |
operator boolC++20 |
Teste se o elements_view não está vazio. |
Requisitos
Cabeçalho: <ranges> (desde C++20)
Namespace: std::ranges
Opção do compilador: /std:c++20 ou posterior é necessária.
Comentários
Os tipos semelhantes a tuplas que você pode usar são elements_view std::tuple, std::paire std::array.
Construtores
Construa uma instância de um elements_viewarquivo .
1) constexpr elements_view(V base);
2) elements_view() requires std::default_initializable<V> = default;
Parâmetros
base
O intervalo subjacente.
Para obter informações sobre o tipo de parâmetro de modelo, consulte Parâmetros de modelo.
Valor retornado
Uma instância elements_view.
Comentários
A melhor maneira de criar um elements_view é usando o adaptador de elements alcance. 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 elements_view a partir da visualização especificada.
2) Construa um elements_viewarquivo .
Exemplo: elements_view
// requires /std:c++20 or later
#include <array>
#include <iostream>
#include <map>
#include <ranges>
#include <vector>
#include <string>
#include <utility>
int main()
{
// ========== work with a std::map
std::map<std::string, int> cpp_standards
{
{"C++98", 1988},
{"C++03", 2003},
{"C++11", 2011},
{"C++14", 2014},
{"C++17", 2017},
{"C++20", 2020}
};
// create an elements_view of all the string elements (<1>) from each tuple
for (int const year : std::views::elements<1>(cpp_standards))
{
std::cout << year << ' '; // 2003 2011 2014 2017 1988 2020
}
std::cout << '\n';
// Another way to call the range adaptor using pipe (|) syntax
for (auto&& name : cpp_standards | std::views::elements<0>)
{
std::cout << name << ' '; // C++03 C++11 C++14 C++17 C++98 C++20
}
std::cout << '\n';
// ========== working with arrays
std::array<std::array<int, 4>, 3> arr = { {{0,1,2,3}, {4,5,6,7}, {8,9,10,11}} };
for (int& fourth : arr | std::views::elements<3>)
{
std::cout << fourth << ' '; // 3 7 11
}
std::cout << '\n';
// ========== work with a std::pair
std::vector<std::pair<std::string, int>> windows
{
{"Windows 1.0", 1985},
{"Windows 2.0", 1987},
{"Windows 3.0", 1990},
{"Windows 3.1", 1992},
{"Windows NT 3.1", 1993},
{"Windows 95", 1995},
{"Windows NT 4.0", 1996},
{"Windows 98", 1998},
{"Windows 2000", 2000}
};
for (int year : std::views::elements<1>(windows))
{
std::cout << year << ' '; // 1985 1987 1990 1992 1993 1995 1996 1998 2000
}
}
2003 2011 2014 2017 1988 2020
C++03 C++11 C++14 C++17 C++98 c++20
3 7 11
1985 1987 1990 1992 1993 1995 1996 1998 2000
base
Obtém uma cópia do intervalo subjacente.
// Uses a copy constructor to return the underlying range
constexpr V base() const& requires std::copy_constructible<V>;
// Uses a move constructor to return the underlying range
constexpr V base() &&;
Parâmetros
Nenhum.
Valor retornado
O intervalo subjacente.
begin
Obtenha um iterador para o primeiro elemento no elements_view.
1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires range<const V>;
Parâmetros
Nenhum.
Valor retornado
Um iterador que aponta para o primeiro elemento no elements_view.
end
Obtenha a sentinela no final do elements_view
1) constexpr auto end() requires (!Simple_view<V> && !ranges::common_range<V>);
2) constexpr auto end() requires (!Simple_view<V> && ranges::common_range<V>);
3) constexpr auto end() const requires ranges::range<const V>;
4) constexpr auto end() const requires ranges::common_range<const V>;
Parâmetros
Nenhum.
Valor retornado
A sentinela que segue o último elemento no elements_view:
size
Obtenha o número de elementos na exibição.
constexpr auto size() requires sized_range<V>;
constexpr auto size() const requires sized_range<const V>;
Parâmetros
Nenhum.
Valor retornado
O número de elementos em elements_view.
Comentários
O tamanho da exibição só estará disponível se o intervalo subjacente for um sized_range, ou em outras palavras, limitado.