keys_view class (Standardowa biblioteka C++)

Widok pierwszego indeksu do każdej wartości podobnej do krotki w kolekcji. Na przykład, biorąc pod uwagę zakres std::tuple<string, int>, utwórz widok składający się ze wszystkich string elementów z każdej krotki.

keys_view jest aliasem elements_view<R, 0> i jest przydatny do wyświetlania kluczy z kontenerów asocjacyjnych, takich jak std::map lub std::unordered_map.

Składnia

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

Parametry szablonu

R
Typ bazowego zakresu. Ten typ musi spełniać ranges::input_rangewartość .

Właściwości widoku

Opis poniższych wpisów można znaleźć w temacie View class characteristics (Wyświetlanie właściwości klas)

Characteristic	opis
Adapter zakresu	views::keys
Zakres bazowy	Musi spełniać input_range lub wyższe
Typ elementu	Taki sam jak typ pierwszego elementu krotki bazowego zakresu
Wyświetl kategorię iteratora	random_access_range jeśli zakres bazowy jest ciągły, w przeciwnym razie jest taki sam jak zakres bazowy
Wielkości	Tylko wtedy, gdy zakres bazowy spełnia sized_range
Jest constiterowalne	Tylko wtedy, gdy zakres bazowy spełnia const-iterable
Wspólny zakres	Tylko wtedy, gdy zakres bazowy spełnia common_range
Pożyczony zakres	Tylko wtedy, gdy zakres bazowy spełnia borrowed_range

Elementy członkowskie

Poniższa lista funkcji składowych odnosi się do keys_view klasy. Pamiętaj, że jest to alias element_view tworzenia wystąpienia szablonu klasy.

Funkcje składowe	Opis
KonstruktoryC++20	Skonstruuj element keys_view.
baseC++20	Pobierz zakres bazowy.
beginC++20	Pobierz iterator do pierwszego elementu.
endC++20	Pobierz element sentinel na końcu widoku.
sizeC++20	Pobierz liczbę elementów. Zakres bazowy musi spełniać sized_rangewartość .
Dziedziczone z view_interface	Opis
backC++20	Pobierz ostatni element.
emptyC++20	Sprawdź, czy element keys_view jest pusty.
frontC++20	Pobierz pierwszy element.
operator[]C++20	Pobierz element na określonej pozycji.
operator boolC++20	Sprawdź, czy element keys_view nie jest pusty.

Wymagania

Nagłówek: <ranges> (od C++20)

Przestrzeń nazw: std::ranges

Opcja kompilatora: /std:c++20 lub nowsza jest wymagana.

Uwagi

Typy podobne do krotki, których można używać, keys_view to std::tuple, std::pairi std::array.

Konstruktory

Skonstruuj wystąpienie klasy keys_view.

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

Parametry

base
Zakres bazowy.

Aby uzyskać informacje o typie parametru szablonu, zobacz Parametry szablonu.

Wartość zwracana

keys_view Wystąpienie.

Uwagi

Najlepszym sposobem utworzenia elementu keys_view jest użycie adaptera keys zakresu. Adaptery zakresów są zamierzonym sposobem tworzenia klas widoków. Typy widoków są widoczne w przypadku utworzenia własnego niestandardowego typu widoku.

1) Utwórz element keys_view z określonego widoku.
2) Domyślny konstruktor tworzy pusty keys_viewobiekt .

Przykład: 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

Pobiera kopię widoku bazowego.

// 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

Brak.

Wartość zwracana

Widok bazowy.

begin

Pobierz iterator do pierwszego elementu w pliku 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

Brak.

Wartość zwracana

Iterator wskazujący pierwszy element w elemecie keys_view.

end

Pobierz sentinel na końcu 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

Brak.

Wartość zwracana

Sentinel, który jest zgodny z ostatnim elementem w pliku keys_view:

size

Pobierz liczbę elementów.

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

Parametry

Brak.

Wartość zwracana

Liczba elementów w elem.keys_view

Uwagi

Rozmiar widoku jest dostępny tylko wtedy, gdy zakres bazowy to sized_range, lub innymi słowy, ograniczony.

Zobacz też

elements_view
values_view
<ranges>
Klasy widoków