keys_view class (standardní knihovna jazyka C++)

Zobrazení prvního indexu do každé hodnoty podobné řazené kolekci členů v kolekci Například vzhledem k rozsahu std::tuple<string, int>, vytvořit zobrazení skládající se ze všech string prvků z každé řazené kolekce členů.

keys_view je alias pro elements_view<R, 0> a je užitečný pro zobrazení klíčů z asociativních kontejnerů jako std::map nebo std::unordered_map.

Syntaxe

template<input_range R>
using keys_view = ranges::elements_view<R, 0>;

Parametry šablony

R
Typ podkladové oblasti. Tento typ musí splňovat ranges::input_range.

Zobrazení charakteristik

Popis následujících položek naleznete v tématu Zobrazení vlastností třídy.

Charakteristika	Popis
Adaptér rozsahu	views::keys
Podkladová oblast	Musí splňovat input_range nebo vyšší
Typ elementu	Stejné jako typ prvního prvku řazené kolekce členů základního rozsahu
Zobrazit kategorii iterátoru	random_access_range pokud je podkladová oblast souvislá, jinak je stejná jako podkladová oblast.
Tříděný	Pouze v případě, že základní rozsah splňuje požadavky sized_range
Je const-iterable	Pouze v případě, že základní rozsah splňuje požadavky const-iterable
Společný rozsah	Pouze v případě, že základní rozsah splňuje požadavky common_range
Zapůjčený rozsah	Pouze v případě, že základní rozsah splňuje požadavky borrowed_range

Členové

Následující seznam členských funkcí odkazuje na keys_view třídu. Vzpomeňte si, že se jedná o alias pro element_view vytvoření instance šablony třídy.

Členské funkce	Popis
KonstruktoryC++20	Vytvoření .keys_view
baseC++20	Získejte podkladovou oblast.
beginC++20	Získejte iterátor k prvnímu prvku.
endC++20	Získejte sentinel na konci zobrazení.
sizeC++20	Získá počet prvků. Základní rozsah musí splňovat sized_range.
Zděděno z view_interface	Popis
backC++20	Získejte poslední prvek.
emptyC++20	Otestujte, jestli keys_view je prázdný.
frontC++20	Získejte první prvek.
operator[]C++20	Získejte prvek na zadané pozici.
operator boolC++20	Otestujte, jestli keys_view není prázdný.

Požadavky

Hlavička: <ranges> (od C++20)

Obor názvů: std::ranges

Je vyžadována možnost kompilátoru: /std:c++20 nebo novější.

Poznámky

Typy řazené kolekce členů, které můžete použít s keys_view , std::tuplestd::paira std::array.

Konstruktory

Vytvoření instance objektu keys_view.

1) constexpr keys_view(V base);
2) keys_view() requires std::default_initializable<V> = default;

Parametry

base
Podkladová oblast.

Informace o typu parametru šablony naleznete v tématu Parametry šablony.

Vrácená hodnota

Instance keys_view .

Poznámky

Nejlepší způsob, jak vytvořit, keys_view je použití adaptéru rozsahu keys . Adaptéry rozsahu představují zamýšlený způsob vytváření tříd zobrazení. Typy zobrazení jsou vystaveny pro případ, že chcete vytvořit vlastní typ zobrazení.

1) Vytvořte ze keys_view zadaného zobrazení.
2) Výchozí konstruktor vytvoří prázdný keys_view.

Příklad: 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

Získá kopii podkladového zobrazení.

// 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() &&;

Parametry

Žádná

Vrácená hodnota

Podkladové zobrazení.

begin

Získejte iterátor na první prvek v objektu 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>;

Parametry

Žádná

Vrácená hodnota

Iterátor ukazující na první prvek v objektu keys_view.

end

Získání sentinelu na konci 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>;

Parametry

Žádná

Vrácená hodnota

Sentinel, který následuje za posledním prvkem v :keys_view

size

Získá počet prvků.

constexpr auto size() requires sized_range<V>
constexpr auto size() const requires sized_range<const V>

Parametry

Žádná

Vrácená hodnota

Počet prvků v souboru keys_view.

Poznámky

Velikost zobrazení je k dispozici pouze v případě, že je podkladová oblast ohraničená sized_range, nebo jinými slovy.

Viz také

elements_view
values_view
<ranges>
Zobrazit třídy