elements_view classe (bibliothèque standard C++)
Vue sur les éléments à un index sélectionné dans chaque valeur de type tuple dans une plage. Par exemple, en fonction d’une plage de std::tuple<string, int>, créez une vue composée des string éléments de chaque tuple.
Syntaxe
template<input_range V, size_t N>
class elements_view : public view_interface<elements_view<V, N>>;
Paramètres de modèle
N
Index de l’élément à sélectionner pour la vue.
V
Type de la plage sous-jacente. Ce type doit satisfaire ranges::input_range.
Afficher les caractéristiques
Pour obtenir une description des entrées suivantes, consultez les caractéristiques de classe View
| Caractéristique | Description |
|---|---|
| Adaptateur de plage | views::elements |
| Plage sous-jacente | Doit satisfaire input_range ou supérieur |
| Type d’élément | Identique au type de l’élément tuple indexé |
| Afficher la catégorie d’itérateur | forward_range, bidirectional_range ou random_access_range |
| Taille | Uniquement si la plage sous-jacente satisfait sized_range |
Est const-itérable |
Uniquement si la plage sous-jacente satisfait const-iterable |
| Plage commune | Uniquement si la plage sous-jacente satisfait common_range |
| Plage empruntée | Uniquement si la plage sous-jacente satisfait borrowed_range |
Membres
| Fonctions membres | Description |
|---|---|
| Constructeurs C++20 | Construisez un elements_view. |
baseC++20 |
Obtenez la plage sous-jacente. |
beginC++20 |
Obtenez un itérateur au premier élément. |
endC++20 |
Obtenez la sentinelle à la fin de la vue. |
sizeC++20 |
Obtenez le nombre d’éléments de cette vue. La plage sous-jacente doit satisfaire sized_range. |
Hérité de view_interface |
Description |
backC++20 |
Obtenez le dernier élément. |
emptyC++20 |
Testez si la valeur elements_view est vide. |
frontC++20 |
Obtenez le premier élément. |
operator[]C++20 |
Obtenez l’élément à la position spécifiée. |
operator boolC++20 |
Testez si la valeur elements_view n’est pas vide. |
Spécifications
En-tête : <ranges> (depuis C++20)
Espace de noms : std::ranges
Option du compilateur : /std:c++20 ou version ultérieure est requise.
Notes
Les types de tuples que vous pouvez utiliser sont elements_view std::tuple, std::pairet std::array.
Constructeurs
Construire une instance d’un elements_view.
1) constexpr elements_view(V base);
2) elements_view() requires std::default_initializable<V> = default;
Paramètres
base
Plage sous-jacente.
Pour plus d’informations sur le type de paramètre de modèle, consultez Paramètres de modèle.
Valeur retournée
Instance de elements_view.
Notes
La meilleure façon de créer un elements_view est d’utiliser l’adaptateur elements de plage. Les adaptateurs de plage sont la méthode prévue pour créer des classes d’affichage. Les types d’affichage sont exposés au cas où vous souhaitez créer votre propre type d’affichage personnalisé.
1) Créez un elements_view élément à partir de la vue spécifiée.
2) Construction par défaut d’un elements_view.
Exemple : 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
Obtient une copie de la plage sous-jacente.
// 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() &&;
Paramètres
Aucune.
Valeur retournée
Plage sous-jacente.
begin
Obtenez un itérateur au premier élément du elements_view.
1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires range<const V>;
Paramètres
Aucune.
Valeur retournée
Itérateur pointant vers le premier élément du elements_view.
end
Obtenir la sentinelle à la fin de la 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>;
Paramètres
Aucune.
Valeur retournée
Sentinel qui suit le dernier élément dans le elements_view:
size
Obtenez le nombre d’éléments dans la vue.
constexpr auto size() requires sized_range<V>;
constexpr auto size() const requires sized_range<const V>;
Paramètres
Aucune.
Valeur retournée
Nombre d'éléments dans elements_view.
Notes
La taille de la vue est disponible uniquement si la plage sous-jacente est limitée sized_range, ou en d’autres termes.