values_view class (стандартная библиотека C++)

Представление, состоящее из второго индекса в каждое кортежное значение в коллекции. Например, учитывая диапазон значений std::tuple<string, int> , создайте представление, состоящее из всех int элементов из каждого кортежа.

values_view является псевдонимом elements_view<R, 1> и полезен для создания представления значений в ассоциативных контейнерах, таких как std::unordered_map.

Синтаксис

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

Параметры шаблона

R
Тип базового диапазона. Этот тип должен соответствовать ranges::input_range.

Просмотр характеристик

Описание следующих записей см. в разделе "Просмотр характеристик класса"

Characteristic	Description
Адаптер диапазона	views::values
Базовый диапазон	Должно соответствовать forward_range или выше
Тип элемента	Совпадает с типом второго элемента кортежа
Просмотр категории итератора	forward_range, bidirectional_range или random_access_range
Размер	Только если базовый диапазон удовлетворяет sized_range
Is const-iterable	Только если базовый диапазон удовлетворяет const-iterable
Общий диапазон	Только если базовый диапазон удовлетворяет common_range
Заимствуемый диапазон	Только если базовый диапазон удовлетворяет borrowed_range

Участники

Функции-члены	Description
КонструкторыC++20	Создайте values_view
baseC++20	Получение базового диапазона.
beginC++20	Получите итератор к первому элементу.
endC++20	Получите sentinel в конце values_view.
sizeC++20	Получение количества элементов.
Наследуется от view_interface	Description
backC++20	Получите последний элемент.
emptyC++20	Проверьте, является ли пустой values_view .
frontC++20	Получите первый элемент.
operator[]C++20	Получите элемент в указанной позиции.
operator boolC++20	Проверьте, не является ли пустой values_view .

Требования

Заголовок: <ranges> (с C++20)

Пространство имен: std::ranges

Параметр компилятора: /std:c++20 или более поздней версии требуется.

Замечания

Типы кортежей, с которыми можно использовать values_view std::tuplestd::pair, и .std::array

Конструкторы

Создание экземпляра values_viewобъекта .

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

Параметры

base
Базовый диапазон типов кортежей.

Сведения о типе параметра шаблона см. в разделе "Параметры шаблона".

Возвращаемое значение

Экземпляр values_view.

Замечания

Лучший способ создания values_view — использовать values адаптер диапазона. Адаптеры диапазона — это способ создания классов представления. Типы представлений предоставляются в случае, если вы хотите создать собственный тип пользовательского представления.

1. Создайте объект values_view из указанного представления.
2. Конструктор по умолчанию создает созданный values_viewпо умолчанию конструктор.

Пример: 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

Получает копию базового представления.

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

Параметры

нет

Возвращаемое значение

Базовое представление.

begin

Получите итератор к первому элементу в элементе 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>;

Параметры

Нет.

Возвращаемое значение

Итератор, указывающий на первый элемент в элементе values_view.

end

Получение sentinel в конце 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>;

Параметры

Нет.

Возвращаемое значение

Sentinel, следующий за последним элементом в values_view

size

Получение количества элементов.

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

Параметры

Нет.

Возвращаемое значение

Число элементов в массиве values_view.

Замечания

Размер представления доступен только в том случае, если базовый диапазон является sized_rangeограничивающим.

См. также

elements_view
keys_view
<ranges>
Просмотр классов