std::ranges::views::transform, std::ranges::transform_view

Определено в заголовке `<ranges>`
template< ranges::input_range V, std::copy_constructible F > requires ranges::view<V> && std::is_object_v<F> && std::regular_invocable<F&, ranges::range_reference_t<V>> && /* invoke_result_t<F&, range_reference_t<V>>& is a valid type */ class transform_view : public ranges::view_interface<transform_view<V, F>>	(1)	(с C++20)
namespace views { inline constexpr /unspecified/ transform = /unspecified/; }	(2)	(с C++20)
Подпись вызова
template< ranges::viewable_range R, class F > requires /* see below */ constexpr ranges::view auto transform( R&& r, F&& fun );		(с C++20)
template< class F > constexpr /range adaptor closure/ transform( F&& fun );		(с C++20)

1) Адаптер диапазонов, представляющий view базовой последовательности после применения функции преобразования к каждому элементу.

2) RangeAdaptorObject. Выражение views::transform(e, f) является эквивалентным по выражениям выражению transform_view(e, f) для любых подходящих подвыражений e и f.

transform_view моделирует концепции random_access_range, bidirectional_range, forward_range, input_range, common_range и sized_range, когда базовый диапазон V моделирует соответствующие концепции.

Члены-функции

(конструктор) (C++20)	создаёт `transform_view` (публичная функция-член)
base (C++20)	возвращает копию базового (адаптированного) диапазона (публичная функция-член)
begin (C++20)	возвращает итератор начала (публичная функция-член)
end (C++20)	возвращает итератор или страж конца (публичная функция-член)
size (C++20)	возвращает количество элементов. Предоставляется только если базовый (адаптированный) диапазон удовлетворяет `sized_range`. (публичная функция-член)
Наследуется от `std::ranges::view_interface`
empty (C++20)	возвращает, пуст ли производный диапазон. Предоставляется, если он удовлетворяет `sized_range` или `forward_range`. (публичная функция-член `std::ranges::view_interface<D>` )
cbegin (C++23)	возвращает постоянный итератор начала диапазона. (публичная функция-член `std::ranges::view_interface<D>` )
cend (C++23)	возвращает страж постоянного итератора диапазона. (публичная функция-член `std::ranges::view_interface<D>` )
operator bool (C++20)	возвращает, не пуст ли производный диапазон. Предоставляется, если `ranges::empty` применимо к нему. (публичная функция-член `std::ranges::view_interface<D>` )
front (C++20)	возвращает первый элемент в производном диапазоне. Предоставляется, если он удовлетворяет `forward_range`. (публичная функция-член `std::ranges::view_interface<D>` )
back (C++20)	возвращает последний элемент в производном диапазоне. Предоставляется, если он удовлетворяет `bidirectional_range` и `common_range`. (публичная функция-член `std::ranges::view_interface<D>` )
operator[] (C++20)	возвращает n-й элемент в производном диапазоне. Предоставляется, если он удовлетворяет `random_access_range`. (публичная функция-член `std::ranges::view_interface<D>` )

Руководства по выводу типов

Вложенные классы

iterator (C++20)	тип итератора (член-шаблон класса только для примера*)
sentinel (C++20)	тип стража (член-шаблон класса только для примера*)

Пример

#include <algorithm>
#include <cstdio>
#include <iterator>
#include <ranges>
#include <string>
 
char rot13a(const char x, const char a)
{
    return a + (x - a + 13) % 26;
}
 
char rot13(const char x)
{
    if ('Z' >= x and x >= 'A')
        return rot13a(x, 'A');
 
    if ('z' >= x and x >= 'a')
        return rot13a(x, 'a');
 
    return x;
}
 
int main()
{
    auto show = [](const unsigned char x) { std::putchar(x); };
 
    std::string in{"cppreference.com\n"};
    std::ranges::for_each(in, show);
    std::ranges::for_each(in | std::views::transform(rot13), show);
 
    std::string out;
    std::ranges::copy(std::views::transform(in, rot13), std::back_inserter(out));
    std::ranges::for_each(out, show);
    std::ranges::for_each(out | std::views::transform(rot13), show);
}

Вывод:

cppreference.com
pccersrerapr.pbz
pccersrerapr.pbz
cppreference.com

См. также

ranges::transform

(C++20)

применяет функцию к диапазону элементов
(функция не имеет побочных эффектов)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/ranges/transform_view