values_view classe (libreria standard C++)

Visualizzazione costituita dal secondo indice in ogni valore simile a una tupla in una raccolta. Ad esempio, dato un intervallo di std::tuple<string, int> valori, creare una vista costituita da tutti gli int elementi di ogni tupla.

values_view è un alias per elements_view<R, 1> ed è utile per creare una visualizzazione dei valori in contenitori associativi, ad std::unordered_mapesempio .

Sintassi

template<input_range R>
using values_view = ranges::elements_view<R, 1>;

Parametri del modello

R
Tipo dell'intervallo sottostante. Questo tipo deve soddisfare ranges::input_range.

Visualizzare le caratteristiche

Per una descrizione delle voci seguenti, vedere Visualizzare le caratteristiche della classe

Caratteristica	Descrizione
Adattatore di intervallo	views::values
Intervallo sottostante	Deve soddisfare forward_range o superiore
Tipo di elemento	Uguale al tipo del secondo elemento della tupla
Visualizzare la categoria iteratore	forward_range, bidirectional_range o random_access_range
Dimensioni	Solo se l'intervallo sottostante soddisfa sized_range
Iterabile const	Solo se l'intervallo sottostante soddisfa const-iterable
Intervallo comune	Solo se l'intervallo sottostante soddisfa common_range
Intervallo preso in prestito	Solo se l'intervallo sottostante soddisfa borrowed_range

Membri

Funzioni membro	Descrizione
Costruttori C++20	Creare un oggetto values_view.
baseC++20	Ottenere l'intervallo sottostante.
beginC++20	Ottenere un iteratore al primo elemento.
endC++20	Ottenere il sentinel alla fine dell'oggetto values_view.
sizeC++20	Ottiene il numero di elementi.
Ereditato da view_interface	Descrizione
backC++20	Ottiene l'ultimo elemento.
emptyC++20	Verificare se l'oggetto values_view è vuoto.
frontC++20	Ottenere il primo elemento.
operator[]C++20	Ottiene l'elemento nella posizione specificata.
operator boolC++20	Verificare se l'oggetto values_view non è vuoto.

Requisiti

Intestazione: <ranges> (da C++20)

Spazio dei nomi: std::ranges

Opzione del compilatore: /std:c++20 o versione successiva è obbligatoria.

Osservazioni:

I tipi simili a tuple che è possibile usare con values_view sono std::tuple, std::paire std::array.

Costruttori

Costruire un'istanza di un oggetto values_view.

1) constexpr values_view(R base);
2) values_view() requires default_initializable<V> = default;

Parametri

base
Intervallo sottostante di tipi simili a tuple.

Per informazioni sul tipo di parametro del modello, vedere Parametri del modello.

Valore restituito

Istanza di values_view.

Osservazioni:

Il modo migliore per creare un values_view oggetto consiste nell'usare l'adattatore values di intervallo. Gli adattatori di intervallo sono il modo previsto per creare classi di visualizzazione. I tipi di visualizzazione vengono esposti nel caso in cui si voglia creare un tipo di visualizzazione personalizzato.

1. Creare un oggetto values_view dalla vista specificata.
2. Il costruttore predefinito crea un oggetto costruito per values_viewimpostazione predefinita.

Esempio: 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

Ottiene una copia della visualizzazione sottostante.

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

Parametri

None

Valore restituito

Visualizzazione sottostante.

begin

Ottenere un iteratore al primo elemento dell'oggetto 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>;

Parametri

Nessuna.

Valore restituito

Iteratore che punta al primo elemento dell'oggetto values_view.

end

Ottenere la sentinella alla fine del 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>;

Parametri

Nessuna.

Valore restituito

Sentinel che segue l'ultimo elemento nell'oggetto values_view

size

Ottiene il numero di elementi.

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

Parametri

Nessuna.

Valore restituito

Numero di elementi in values_view.

Osservazioni:

Le dimensioni della vista sono disponibili solo se l'intervallo sottostante è , sized_rangeo in altre parole, delimitato.

Vedi anche

elements_view
keys_view
<ranges>
Visualizzare le classi