values_view
class (Standardowa biblioteka C++)
Widok składający się z drugiego indeksu do każdej wartości podobnej do krotki w kolekcji. Na przykład, biorąc pod uwagę zakres std::tuple<string, int>
wartości, utwórz widok składający się ze wszystkich int
elementów z każdej krotki.
values_view
jest aliasem elements_view<R, 1>
i jest przydatny do tworzenia widoku wartości w kontenerach asocjacyjnych, takich jak std::unordered_map
.
Składnia
template<input_range R>
using values_view = ranges::elements_view<R, 1>;
Parametry szablonu
R
Typ bazowego zakresu. Ten typ musi spełniać ranges::input_range
wartość .
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::values |
Zakres bazowy | Musi spełniać forward_range lub wyższe |
Typ elementu | Taki sam jak typ drugiego elementu krotki |
Wyświetl kategorię iteratora | forward_range , bidirectional_range lub random_access_range |
Wielkości | Tylko wtedy, gdy zakres bazowy spełnia sized_range |
Jest const iterowalne |
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
Funkcje składowe | Opis |
---|---|
KonstruktoryC++20 | Skonstruuj element values_view . |
base C++20 |
Pobierz zakres bazowy. |
begin C++20 |
Pobierz iterator do pierwszego elementu. |
end C++20 |
Pobierz element sentinel na końcu obiektu values_view . |
size C++20 |
Pobierz liczbę elementów. |
Dziedziczone z view_interface |
Opis |
back C++20 |
Pobierz ostatni element. |
empty C++20 |
Sprawdź, czy element values_view jest pusty. |
front C++20 |
Pobierz pierwszy element. |
operator[] C++20 |
Pobierz element na określonej pozycji. |
operator bool C++20 |
Sprawdź, czy element values_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ć, values_view
to std::tuple
, std::pair
i std::array
.
Konstruktory
Skonstruuj wystąpienie klasy values_view
.
1) constexpr values_view(R base);
2) values_view() requires default_initializable<V> = default;
Parametry
base
Podstawowy zakres typów podobnych do krotki.
Aby uzyskać informacje o typie parametru szablonu, zobacz Parametry szablonu.
Wartość zwracana
Wystąpienie values_view
.
Uwagi
Najlepszym sposobem utworzenia elementu values_view
jest użycie adaptera values
zakresu. Adaptery zakresów są zamierzonym sposobem tworzenia klas widoków. Typy widoków są widoczne w przypadku utworzenia własnego niestandardowego typu widoku.
- Utwórz element
values_view
z określonego widoku. - Domyślny konstruktor tworzy skonstruowany
values_view
domyślnie .
Przykład: values_view
// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <map>
#include <string>
#include <utility>
#include <vector>
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 values from the map
for (int years : std::views::values(cpp_standards))
{
std::cout << years << ' '; // 2003 2011 2014 2017 1988 2020
}
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 95", 1995},
{"Windows 98", 1998},
{"Windows 1.0", 1985},
{"Windows 2000", 2000}
};
// Another way to call the range adaptor using '|': create a keys_view from each pair
for (int years : windows | std::views::values)
{
std::cout << years << ' '; // 1985 1987 1990 1992 ...
}
}
2003 2011 2014 2017 1988 2020
1985 1987 1990 1992 1993 1995 1996 1995 1998 1985 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 values_view
.
// returns a non-const iterator
1) constexpr auto begin() requires (!Simple_view<V>);
// returns a const iterator
2) constexpr auto begin() const requires ranges::range<const V>;
Parametry
Brak.
Wartość zwracana
Iterator wskazujący pierwszy element w elemecie values_view
.
end
Pobierz sentinel na końcu values_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 elemecie values_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.values_view
Uwagi
Rozmiar widoku jest dostępny tylko wtedy, gdy zakres bazowy to sized_range
, lub innymi słowy, ograniczony.
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla