elements_view class (стандартная библиотека C++)
Представление элементов по выбранному индексу в каждом значении кортежа в диапазоне. Например, учитывая диапазон std::tuple<string, int>, создайте представление, состоящее из string элементов из каждого кортежа.
Синтаксис
template<input_range V, size_t N>
class elements_view : public view_interface<elements_view<V, N>>;
Параметры шаблона
N
Индекс элемента, выбранного для представления.
V
Тип базового диапазона. Этот тип должен соответствовать ranges::input_range.
Просмотр характеристик
Описание следующих записей см. в разделе "Просмотр характеристик класса"
| Characteristic | Description |
|---|---|
| Адаптер диапазона | views::elements |
| Базовый диапазон | Должно соответствовать input_range или выше |
| Тип элемента | Совпадает с типом индексированного элемента кортежа |
| Просмотр категории итератора | forward_range, bidirectional_range или random_access_range |
| Размер | Только если базовый диапазон удовлетворяет sized_range |
Is const-iterable |
Только если базовый диапазон удовлетворяет const-iterable |
| Общий диапазон | Только если базовый диапазон удовлетворяет common_range |
| Заимствуемый диапазон | Только если базовый диапазон удовлетворяет borrowed_range |
Участники
| Функции-члены | Description |
|---|---|
| КонструкторыC++20 | Создайте elements_view |
baseC++20 |
Получение базового диапазона. |
beginC++20 |
Получите итератор к первому элементу. |
endC++20 |
Получите sentinel в конце представления. |
sizeC++20 |
Получите количество элементов в этом представлении. Базовый диапазон должен удовлетворять sized_range. |
Наследуется от view_interface |
Description |
backC++20 |
Получите последний элемент. |
emptyC++20 |
Проверьте, является ли пустой elements_view . |
frontC++20 |
Получите первый элемент. |
operator[]C++20 |
Получите элемент в указанной позиции. |
operator boolC++20 |
Проверьте, не является ли пустой elements_view . |
Требования
Заголовок: <ranges> (с C++20)
Пространство имен: std::ranges
Параметр компилятора: /std:c++20 или более поздней версии требуется.
Замечания
Типы кортежей, с которыми можно использовать elements_view std::tuplestd::pair, и std::array.
Конструкторы
Создание экземпляра elements_viewобъекта .
1) constexpr elements_view(V base);
2) elements_view() requires std::default_initializable<V> = default;
Параметры
base
Базовый диапазон.
Сведения о типе параметра шаблона см. в разделе "Параметры шаблона".
Возвращаемое значение
Экземпляр elements_view.
Замечания
Лучший способ создания elements_view — использовать elements адаптер диапазона. Адаптеры диапазона — это способ создания классов представления. Типы представлений предоставляются в случае, если вы хотите создать собственный тип пользовательского представления.
1) Создание elements_view из указанного представления.
2) Конструкция elements_viewпо умолчанию.
Пример: elements_view
// requires /std:c++20 or later
#include <array>
#include <iostream>
#include <map>
#include <ranges>
#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}
};
// create an elements_view of all the string elements (<1>) from each tuple
for (int const year : std::views::elements<1>(cpp_standards))
{
std::cout << year << ' '; // 2003 2011 2014 2017 1988 2020
}
std::cout << '\n';
// Another way to call the range adaptor using pipe (|) syntax
for (auto&& name : cpp_standards | std::views::elements<0>)
{
std::cout << name << ' '; // C++03 C++11 C++14 C++17 C++98 C++20
}
std::cout << '\n';
// ========== working with arrays
std::array<std::array<int, 4>, 3> arr = { {{0,1,2,3}, {4,5,6,7}, {8,9,10,11}} };
for (int& fourth : arr | std::views::elements<3>)
{
std::cout << fourth << ' '; // 3 7 11
}
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 98", 1998},
{"Windows 2000", 2000}
};
for (int year : std::views::elements<1>(windows))
{
std::cout << year << ' '; // 1985 1987 1990 1992 1993 1995 1996 1998 2000
}
}
2003 2011 2014 2017 1988 2020
C++03 C++11 C++14 C++17 C++98 c++20
3 7 11
1985 1987 1990 1992 1993 1995 1996 1998 2000
base
Возвращает копию базового диапазона.
// Uses a copy constructor to return the underlying range
constexpr V base() const& requires std::copy_constructible<V>;
// Uses a move constructor to return the underlying range
constexpr V base() &&;
Параметры
Нет.
Возвращаемое значение
Базовый диапазон.
begin
Получите итератор к первому элементу в элементе elements_view.
1) constexpr auto begin() requires (!Simple_view<V>);
2) constexpr auto begin() const requires range<const V>;
Параметры
Нет.
Возвращаемое значение
Итератор, указывающий на первый элемент в элементе elements_view.
end
Получение sentinel в конце elements_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, следующий за последним элементом elements_viewв :
size
Получение количества элементов в представлении.
constexpr auto size() requires sized_range<V>;
constexpr auto size() const requires sized_range<const V>;
Параметры
Нет.
Возвращаемое значение
Число элементов в массиве elements_view.
Замечания
Размер представления доступен только в том случае, если базовый диапазон является sized_rangeограничивающим.