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

Представление элементов, каждое из которых является преобразованием элемента в указанном диапазоне.

Синтаксис

template<input_range V, move_constructible F>
    requires view<V> && is_object_v<F> &&
    regular_invocable<F&, range_reference_t<V>> &&
    can-reference<invoke_result_t<F&, range_reference_t<V>>>
class transform_view : public view_interface<transform_view<V, F>>;

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

F
Тип объекта функции, преобразующего элементы.

V
Тип базового представления.

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

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

Characteristic	Description
Адаптер диапазона	views::transform
Базовый диапазон	Должно соответствовать input_range или выше
Тип элемента	То же, что и возвращаемый тип функции преобразования.
Просмотр категории итератора	Поддерживает input_range до random_access_range, в зависимости от базового диапазона
Размер	Только если базовый диапазон удовлетворяет sized_range
Is const-iterable	Только если базовый диапазон является const итерируемым, и преобразование работает над const ссылками.
Общий диапазон	Только если базовый диапазон удовлетворяет common_range
Заимствуемый диапазон	No

Участники

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

Требования

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

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

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

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

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

1) transform_view() requires default_initializable<V>
         && default_initializable<F> = default;
2) constexpr transform_view(V base, F func);

Параметры

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

func
Функция, которая преобразует каждый элемент.

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

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

Экземпляр класса transform_view.

Замечания

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

1) Создание инициализированного transform_viewзначения. Функция преобразования и базовое представление должны быть инициализируемыми по умолчанию.
2) Перемещение конструкции transform_view из base представления и функции funcпреобразования. Оба base и func перемещаются через std::move().

Пример: transform_view

// requires /std:c++20 or later
#include <ranges>
#include <iostream>
#include <vector>
#include <chrono>

using namespace std;
using namespace chrono;

void print(auto v)
{
    for (auto x : v)
    {
        cout << x << ' ';
    }
    cout << '\n';
}

struct classes
{
    string className;
    weekday startDay;
};

int main()
{
    std::vector<int> v{0, 1, 2, 3, -4, 5, 6};

    // outputs 0 2 4 6 -8 10 12
    print(v | std::views::transform([](int i) {return i * 2; }));

    // ---- Modify the elements in the collection by returning a reference to the element to transform

    std::vector<classes> theClasses = {
        {"Math", Monday},
        {"English", Wednesday},
        {"History", Monday},
        {"Science", Wednesday},
        {"Art", Friday},
        {"Music", Thursday}
    };

    // lambda to get a reference to the day of the week for a class
    auto getDay = [](classes& c) -> weekday&
    {
        return c.startDay;
    };

    // If a class starts on Monday, change it to Tuesday
    for (auto&& startDay : theClasses | std::views::transform(getDay))
    {
        // modify the startDay in the collection
        if (startDay == Monday)
        {
            startDay = Tuesday;
        }
    }

    // output classes and start times
    for (auto c : theClasses)
    {
        std::cout << c.className << " : " << c.startDay << '\n';
    }
}

0 2 4 6 -8 10 12
Math : Tue
English : Wed
History : Tue
Science : Wed
Art : Fri
Music : Thu

base

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

// Uses a copy constructor to return the underlying view
constexpr V base() const& requires std::copy_constructible<V>;

// Uses std::move() to return the underlying view
constexpr V base() &&;

Параметры

Нет.

Возвраты

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

begin

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

constexpr auto begin();

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

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

end

Получите sentinel в конце представления.

constexpr auto end()

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

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

size

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

constexpr auto size() requires ranges::sized_range<V>;
constexpr auto size() const requires ranges::sized_range<const V>;

Параметры

Нет.

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

Количество элементов в представлении.

См. также

<ranges>
filter адаптер диапазона
Классы представления