elements_view classe (libreria standard C++)
Visualizzazione degli elementi in corrispondenza di un indice selezionato in ogni valore simile a una tupla in un intervallo. Ad esempio, dato un intervallo di std::tuple<string, int>, creare una vista costituita dagli elementi di string ogni tupla.
Sintassi
template<input_range V, size_t N>
class elements_view : public view_interface<elements_view<V, N>>;
Parametri del modello
N
Indice dell'elemento da selezionare per la vista.
V
Tipo dell'intervallo sottostante. Questo tipo deve soddisfare ranges::input_range.
Visualizzare le caratteristiche
Per una descrizione delle voci seguenti, vedere Visualizzare le caratteristiche della classe
| Caratteristica | Descrizione |
|---|---|
| Adattatore di intervallo | views::elements |
| Intervallo sottostante | Deve soddisfare input_range o superiore |
| Tipo di elemento | Uguale al tipo dell'elemento tupla indicizzata |
| Visualizzare la categoria iteratore | forward_range, bidirectional_range o random_access_range |
| Dimensioni | Solo se l'intervallo sottostante soddisfa sized_range |
Iterabile const |
Solo se l'intervallo sottostante soddisfa const-iterable |
| Intervallo comune | Solo se l'intervallo sottostante soddisfa common_range |
| Intervallo preso in prestito | Solo se l'intervallo sottostante soddisfa borrowed_range |
Membri
| Funzioni membro | Descrizione |
|---|---|
| Costruttori C++20 | Creare un oggetto elements_view. |
baseC++20 |
Ottenere l'intervallo sottostante. |
beginC++20 |
Ottenere un iteratore al primo elemento. |
endC++20 |
Ottenere l'sentinel alla fine della visualizzazione. |
sizeC++20 |
Ottiene il numero di elementi in questa visualizzazione. L'intervallo sottostante deve soddisfare sized_range. |
Ereditato da view_interface |
Descrizione |
backC++20 |
Ottiene l'ultimo elemento. |
emptyC++20 |
Verificare se l'oggetto elements_view è vuoto. |
frontC++20 |
Ottenere il primo elemento. |
operator[]C++20 |
Ottiene l'elemento nella posizione specificata. |
operator boolC++20 |
Verificare se l'oggetto elements_view non è vuoto. |
Requisiti
Intestazione: <ranges> (da C++20)
Spazio dei nomi: std::ranges
Opzione del compilatore: /std:c++20 o versione successiva è obbligatoria.
Osservazioni:
I tipi simili a tupla che è possibile usare con elements_view sono std::tuple, std::paire std::array.
Costruttori
Costruire un'istanza di un oggetto elements_view.
1) constexpr elements_view(V base);
2) elements_view() requires std::default_initializable<V> = default;
Parametri
base
Intervallo sottostante.
Per informazioni sul tipo di parametro del modello, vedere Parametri del modello.
Valore restituito
Istanza di elements_view.
Osservazioni:
Il modo migliore per creare un elements_view oggetto consiste nell'usare l'adattatore elements di intervallo. Gli adattatori di intervallo sono il modo previsto per creare classi di visualizzazione. I tipi di visualizzazione vengono esposti nel caso in cui si voglia creare un tipo di visualizzazione personalizzato.
1) Creare un oggetto elements_view dalla vista specificata.
2) Costruire per impostazione predefinita un oggetto elements_view.
Esempio: 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
Ottiene una copia dell'intervallo sottostante.
// 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() &&;
Parametri
Nessuna.
Valore restituito
Intervallo sottostante.
begin
Ottenere un iteratore al primo elemento dell'oggetto elements_view.
1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires range<const V>;
Parametri
Nessuna.
Valore restituito
Iteratore che punta al primo elemento dell'oggetto elements_view.
end
Ottenere la sentinella alla fine del 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>;
Parametri
Nessuna.
Valore restituito
Sentinel che segue l'ultimo elemento in elements_view:
size
Ottiene il numero di elementi nella visualizzazione.
constexpr auto size() requires sized_range<V>;
constexpr auto size() const requires sized_range<const V>;
Parametri
Nessuna.
Valore restituito
Numero di elementi in elements_view.
Osservazioni:
Le dimensioni della vista sono disponibili solo se l'intervallo sottostante è , sized_rangeo in altre parole, delimitato.