Classe values_view (Biblioteca Padrão C++)

Uma exibição que consiste no segundo índice em cada valor semelhante a uma tupla em uma coleção. Por exemplo, dado um intervalo de std::tuple<string, int> valores, crie uma exibição que consiste em todos os int elementos de cada tupla.

values_view é um alias e elements_view<R, 1> é útil para criar uma exibição dos valores em contêineres associativos, como std::unordered_map.

Sintaxe

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

Parâmetros de modelo

R
O tipo do intervalo subjacente. Este tipo deve satisfazer ranges::input_range.

Ver características

Para obter uma descrição das entradas a seguir, consulte Exibir características da classe

Característica	Descrição
Adaptador de gama	views::values
Intervalo subjacente	Deve satisfazer forward_range ou superior
Tipo de elemento	O mesmo que o tipo do segundo elemento de tupla
Exibir categoria do iterador	forward_range, bidirectional_range ou random_access_range
Tamanho	Somente se o intervalo subjacente satisfizer sized_range
É const-iterável	Somente se o intervalo subjacente satisfizer const-iterable
Faixa comum	Somente se o intervalo subjacente satisfizer common_range
Alcance emprestado	Somente se o intervalo subjacente satisfizer borrowed_range

Membros

Funções de membro	Descrição
ConstrutoresC++20	Construa um values_view.
baseC++20	Obtenha o intervalo subjacente.
beginC++20	Obtenha um iterador para o primeiro elemento.
endC++20	Obtenha o sentinela no final do values_viewarquivo .
sizeC++20	Obtenha o número de elementos.
Herdado de view_interface	Descrição
backC++20	Obtenha o último elemento.
emptyC++20	Testar se o values_view está vazio.
frontC++20	Obtenha o primeiro elemento.
operator[]C++20	Obter o elemento na posição especificada.
operator boolC++20	Teste se o values_view não está vazio.

Requisitos

Cabeçalho: <ranges> (desde C++20)

Namespace: std::ranges

Opção do compilador: /std:c++20 ou posterior é necessária.

Comentários

Os tipos semelhantes a tuplas que você pode usar são values_view std::tuple, std::pair, e std::array.

Construtores

Construa uma instância de um values_viewarquivo .

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

Parâmetros

base
O intervalo subjacente de tipos semelhantes a tuplas.

Para obter informações sobre o tipo de parâmetro de modelo, consulte Parâmetros de modelo.

Valor retornado

Uma instância values_view.

Comentários

A melhor maneira de criar um values_view é usando o adaptador de values alcance. Os adaptadores de intervalo são a maneira pretendida de criar classes de exibição. Os tipos de exibição são expostos caso você queira criar seu próprio tipo de exibição personalizado.

1. Crie um values_view a partir da visualização especificada.
2. O construtor padrão cria um values_view.

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

Obtém uma cópia da exibição subjacente.

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

Parâmetros

Nenhum

Valor retornado

A visão subjacente.

begin

Obtenha um iterador para o primeiro elemento no 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>;

Parâmetros

Nenhum.

Valor retornado

Um iterador que aponta para o primeiro elemento no values_view.

end

Obtenha a sentinela no final do 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>;

Parâmetros

Nenhum.

Valor retornado

A sentinela que segue o último elemento no values_view

size

Obtenha o número de elementos.

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

Parâmetros

Nenhum.

Valor retornado

O número de elementos em values_view.

Comentários

O tamanho da exibição só estará disponível se o intervalo subjacente for um sized_range, ou em outras palavras, limitado.

Confira também

elements_view
keys_view
<ranges>
Ver aulas