keys_view classe (bibliothèque standard C++)
Vue sur le premier index dans chaque valeur de type tuple dans une collection. Par exemple, en fonction d’une plage de std::tuple<string, int>, créez une vue composée de tous les string éléments de chaque tuple.
keys_view est un alias pour elements_view<R, 0> lequel il est utile d’afficher les clés à partir de conteneurs associatifs comme std::map ou std::unordered_map.
Syntaxe
template<input_range R>
using keys_view = ranges::elements_view<R, 0>;
Paramètres de modèle
R
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::keys |
| Plage sous-jacente | Doit satisfaire input_range ou supérieur |
| Type d’élément | Identique au type du premier élément tuple de la plage sous-jacente |
| Afficher la catégorie d’itérateur | random_access_range si la plage sous-jacente est contiguë, sinon identique à la plage sous-jacente |
| 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
La liste suivante des fonctions membres fait référence à la keys_view classe. Rappelez-vous qu’il s’agit d’un alias pour l’instanciation d’un element_view modèle de classe.
| Fonctions membres | Description |
|---|---|
| Constructeurs C++20 | Construisez un keys_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. 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 keys_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 keys_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 keys_view std::tuple, std::pairet std::array.
Constructeurs
Construire une instance d’un keys_view.
1) constexpr keys_view(V base);
2) keys_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 keys_view.
Notes
La meilleure façon de créer un keys_view est d’utiliser l’adaptateur keys 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 keys_view à partir de la vue spécifiée.
2) Le constructeur par défaut crée un constructeur vide keys_view.
Exemple : keys_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <map>
#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}
};
// Extract all of the keys from the map
for (const std::string& standards : std::views::keys(cpp_standards))
{
std::cout << standards << ' '; // C++03 C++11 C++14 C++17 C++98 C++20
}
std::cout << '\n';
// ========== work with a range of 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 95", 1995},
{"Windows 98", 1998},
{"Windows 1.0", 1985},
{"Windows 2000", 2000}
};
// Another way to call the range adaptor using '|': create an keys_view from each pair
for (const std::string& version : windows | std::views::keys)
{
std::cout << version << ' '; // Windows 1.0 Windows 2.0 Windows 3.0 ...
}
}
C++03 C++11 C++14 C++17 C++98 c++20
Windows 1.0 Windows 2.0 Windows 3.0 Windows 3.1 Windows NT 3.1 Windows 95 Windows NT 4.0 Windows 95 Windows 98 Windows 1.0 Windows 2000
base
Obtient une copie de la vue sous-jacente.
// Uses a copy constructor to return the underlying view
constexpr V base() const& requires std::copy_constructible<V>;
// Uses a move constructor to return the underlying view
constexpr V base() &&;
Paramètres
Aucune.
Valeur retournée
Vue sous-jacente.
begin
Obtenez un itérateur au premier élément du keys_view.
1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires (Simple_view<V>) // or put another way, requires ranges::range<const V>;
Paramètres
Aucune.
Valeur retournée
Itérateur pointant vers le premier élément du keys_view.
end
Obtenir la sentinelle à la fin de la keys_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 keys_view:
size
Obtenez le nombre d’éléments.
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 keys_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.