transform_view class (standardní knihovna jazyka C++)

Zobrazení prvků, z nichž každý je transformací prvku v zadaném rozsahu.

Syntaxe

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>>;

Parametry šablony

F
Typ objektu funkce, který transformuje prvky.

V
Typ podkladového zobrazení.

Zobrazení charakteristik

Popis následujících položek naleznete v tématu Zobrazení vlastností třídy.

Charakteristika	Popis
Adaptér rozsahu	views::transform
Podkladová oblast	Musí splňovat input_range nebo vyšší
Typ elementu	Stejné jako návratový typ transformační funkce.
Zobrazit kategorii iterátoru	Podporuje input_range až random_access_range, v závislosti na podkladovém rozsahu
Tříděný	Pouze v případě, že základní rozsah splňuje požadavky sized_range
Je const-iterable	Pouze pokud je const podkladová oblast iterovatelná a transformace funguje na const odkazech.
Společný rozsah	Pouze v případě, že základní rozsah splňuje požadavky common_range
Zapůjčený rozsah	No

Členové

Členské funkce	Popis
KonstruktoryC++20	Vytvořte zobrazení.
baseC++20	Získejte podkladovou oblast.
beginC++20	Získejte iterátor k prvnímu prvku.
endC++20	Získejte sentinel na konci zobrazení.
sizeC++20	Získá počet prvků. Základní rozsah musí splňovat sized_range.
Zděděno z view_interface	Popis
backC++20	Získejte poslední prvek.
emptyC++20	Otestujte, jestli je zobrazení prázdné.
frontC++20	Získejte první prvek.
operator boolC++20	Otestujte, jestli zobrazení není prázdné.
operator[]C++20	Získejte prvek na zadané pozici.

Požadavky

Hlavička: <ranges> (od C++20)

Obor názvů: std::ranges

Je vyžadována možnost kompilátoru: /std:c++20 nebo novější.

Konstruktory

Vytvoření instance objektu transform_view

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

Parametry

base
Podkladové zobrazení.

func
Funkce, která transformuje každý prvek.

Informace o typech parametrů šablony naleznete v tématu Parametry šablony.

Vrácená hodnota

Instance transform_view .

Poznámky

Nejlepší způsob, jak vytvořit, transform_view je použití adaptéru rozsahu views::transform . Adaptéry rozsahu představují zamýšlený způsob vytváření tříd zobrazení. Typy zobrazení jsou vystaveny pro případ, že chcete vytvořit vlastní typ zobrazení.

1) Vytvoření inicializované transform_viewhodnoty . Transformační funkce a podkladové zobrazení musí být výchozí inicializovatelné.
2) Přesunutí konstrukce transform_view ze base zobrazení a transformační funkce func. Obě base a func jsou přesunuty přes std::move().

Příklad: 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

Získejte podkladové zobrazení.

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

Parametry

Žádná

Návraty

Podkladové zobrazení.

begin

Získejte iterátor k prvnímu prvku v zobrazení.

constexpr auto begin();

Vrácená hodnota

Iterátor ukazující na první prvek v zobrazení. Toto chování není definováno, pokud zobrazení nemá predikát.

end

Získejte sentinel na konci zobrazení.

constexpr auto end()

Vrácená hodnota

Sentinel, který následuje za posledním prvkem v zobrazení:

size

Získejte počet prvků v zobrazení.

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

Parametry

Žádná

Vrácená hodnota

Počet prvků v zobrazení.

Viz také

<ranges>
filter adaptér rozsahu
zobrazit třídy