keys_view class (стандартная библиотека C++)
Представление по первому индексу в каждом кортеже, как значение в коллекции. Например, учитывая диапазон std::tuple<string, int>, создайте представление, состоящее из всех string элементов из каждого кортежа.
keys_view — это псевдоним elements_view<R, 0> и полезный для просмотра ключей из ассоциативных контейнеров, таких как std::map или std::unordered_map.
Синтаксис
template<input_range R>
using keys_view = ranges::elements_view<R, 0>;
Параметры шаблона
R
Тип базового диапазона. Этот тип должен соответствовать ranges::input_range.
Просмотр характеристик
Описание следующих записей см. в разделе "Просмотр характеристик класса"
| Characteristic | Description |
|---|---|
| Адаптер диапазона | views::keys |
| Базовый диапазон | Должно соответствовать input_range или выше |
| Тип элемента | Совпадает с типом первого элемента кортежа базового диапазона. |
| Просмотр категории итератора | random_access_range Значение , если базовый диапазон является непрерывным, в противном случае совпадает с базовым диапазоном. |
| Размер | Только если базовый диапазон удовлетворяет sized_range |
Is const-iterable |
Только если базовый диапазон удовлетворяет const-iterable |
| Общий диапазон | Только если базовый диапазон удовлетворяет common_range |
| Заимствуемый диапазон | Только если базовый диапазон удовлетворяет borrowed_range |
Участники
Следующий список функций-членов относится к классу keys_view . Помните, что это псевдоним для создания экземпляра element_view шаблона класса.
| Функции-члены | Description |
|---|---|
| КонструкторыC++20 | Создайте keys_view |
baseC++20 |
Получение базового диапазона. |
beginC++20 |
Получите итератор к первому элементу. |
endC++20 |
Получите sentinel в конце представления. |
sizeC++20 |
Получение количества элементов. Базовый диапазон должен удовлетворять sized_range. |
Наследуется от view_interface |
Description |
backC++20 |
Получите последний элемент. |
emptyC++20 |
Проверьте, является ли пустой keys_view . |
frontC++20 |
Получите первый элемент. |
operator[]C++20 |
Получите элемент в указанной позиции. |
operator boolC++20 |
Проверьте, не является ли пустой keys_view . |
Требования
Заголовок: <ranges> (с C++20)
Пространство имен: std::ranges
Параметр компилятора: /std:c++20 или более поздней версии требуется.
Замечания
Типы кортежей, с которыми можно использовать keys_view std::tuplestd::pair, и std::array.
Конструкторы
Создание экземпляра keys_viewобъекта .
1) constexpr keys_view(V base);
2) keys_view() requires std::default_initializable<V> = default;
Параметры
base
Базовый диапазон.
Сведения о типе параметра шаблона см. в разделе "Параметры шаблона".
Возвращаемое значение
Экземпляр класса keys_view.
Замечания
Лучший способ создания keys_view — использовать keys адаптер диапазона. Адаптеры диапазона — это способ создания классов представления. Типы представлений предоставляются в случае, если вы хотите создать собственный тип пользовательского представления.
1) Создание keys_view из указанного представления.
2) Конструктор по умолчанию создает пустое keys_view.
Пример: 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
Получает копию базового представления.
// 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
Получите итератор к первому элементу в элементе 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>;
Параметры
Нет.
Возвращаемое значение
Итератор, указывающий на первый элемент в элементе keys_view.
end
Получение sentinel в конце 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>;
Параметры
Нет.
Возвращаемое значение
Sentinel, следующий за последним элементом keys_viewв :
size
Получение количества элементов.
constexpr auto size() requires sized_range<V>
constexpr auto size() const requires sized_range<const V>
Параметры
Нет.
Возвращаемое значение
Число элементов в массиве keys_view.
Замечания
Размер представления доступен только в том случае, если базовый диапазон является sized_rangeограничивающим.