transform_view class (Standardowa biblioteka C++)

Widok elementów, z których każda jest przekształceniem elementu w określonym zakresie.

Składnia

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 szablonu

F
Typ obiektu funkcji, który przekształca elementy.

V
Typ widoku bazowego.

Właściwości widoku

Opis poniższych wpisów można znaleźć w temacie View class characteristics (Wyświetlanie właściwości klas)

Characteristic	opis
Adapter zakresu	views::transform
Zakres bazowy	Musi spełniać input_range lub wyższe
Typ elementu	Taki sam jak zwracany typ funkcji przekształcania.
Wyświetl kategorię iteratora	Obsługuje input_range do random_access_range, w zależności od bazowego zakresu
Wielkości	Tylko wtedy, gdy zakres bazowy spełnia sized_range
Jest constiterowalne	Tylko wtedy, gdy zakres bazowy jest const iterowalny, a przekształcenie działa na const odwołaniach.
Wspólny zakres	Tylko wtedy, gdy zakres bazowy spełnia common_range
Pożyczony zakres	Nie.

Elementy członkowskie

Funkcje składowe	Opis
KonstruktoryC++20	Skonstruuj widok.
baseC++20	Pobierz zakres bazowy.
beginC++20	Pobierz iterator do pierwszego elementu.
endC++20	Pobierz element sentinel na końcu widoku.
sizeC++20	Pobierz liczbę elementów. Zakres bazowy musi spełniać sized_rangewartość .
Dziedziczone z view_interface	Opis
backC++20	Pobierz ostatni element.
emptyC++20	Sprawdź, czy widok jest pusty.
frontC++20	Pobierz pierwszy element.
operator boolC++20	Sprawdź, czy widok nie jest pusty.
operator[]C++20	Pobierz element na określonej pozycji.

Wymagania

Nagłówek: <ranges> (od C++20)

Przestrzeń nazw: std::ranges

Opcja kompilatora: /std:c++20 lub nowsza jest wymagana.

Konstruktory

Konstruowanie wystąpienia obiektu transform_view

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

Parametry

base
Widok bazowy.

func
Funkcja, która przekształca każdy element.

Aby uzyskać informacje o typach parametrów szablonu, zobacz Parametry szablonu.

Wartość zwracana

transform_view Wystąpienie.

Uwagi

Najlepszym sposobem utworzenia elementu transform_view jest użycie adaptera views::transform zakresu. Adaptery zakresów są zamierzonym sposobem tworzenia klas widoków. Typy widoków są widoczne w przypadku utworzenia własnego niestandardowego typu widoku.

1) Utwórz wartość zainicjowaną transform_view. Funkcja przekształcania i widok bazowy muszą być inicjowane domyślnie.
2) Przenieś konstrukcję transform_view base z widoku i funkcji funcprzekształcania . Obie base metody i func są przenoszone za pośrednictwem metody std::move().

Przykład: 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

Pobierz widok bazowy.

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

Brak.

Zwraca

Widok bazowy.

begin

Pobierz iterator do pierwszego elementu w widoku.

constexpr auto begin();

Wartość zwracana

Iterator wskazujący pierwszy element w widoku. Zachowanie jest niezdefiniowane, jeśli widok nie ma predykatu.

end

Pobierz element sentinel na końcu widoku.

constexpr auto end()

Wartość zwracana

Sentinel, który jest zgodny z ostatnim elementem w widoku:

size

Pobierz liczbę elementów w widoku.

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

Parametry

Brak.

Wartość zwracana

Liczba elementów w widoku.

Zobacz też

<ranges>
filter adapter zakresu
klasy widoków