transform_view classe (libreria standard C++)

Visualizzazione degli elementi, ognuno dei quali è una trasformazione di un elemento nell'intervallo specificato.

Sintassi

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

Parametri del modello

F
Tipo dell'oggetto funzione che trasforma gli elementi.

V
Tipo della vista sottostante.

Visualizzare le caratteristiche

Per una descrizione delle voci seguenti, vedere Visualizzare le caratteristiche della classe

Caratteristica	Descrizione
Adattatore di intervallo	views::transform
Intervallo sottostante	Deve soddisfare input_range o superiore
Tipo di elemento	Uguale al tipo restituito della funzione di trasformazione.
Visualizzare la categoria iteratore	Supporta input_range fino a random_access_range, a seconda dell'intervallo sottostante
Dimensioni	Solo se l'intervallo sottostante soddisfa sized_range
Iterabile const	Solo se l'intervallo sottostante è const iterabile e la trasformazione funziona sui const riferimenti.
Intervallo comune	Solo se l'intervallo sottostante soddisfa common_range
Intervallo preso in prestito	No

Membri

Funzioni membro	Descrizione
Costruttori C++20	Costruisci la vista.
baseC++20	Ottenere l'intervallo sottostante.
beginC++20	Ottenere un iteratore al primo elemento.
endC++20	Ottenere l'sentinel alla fine della visualizzazione.
sizeC++20	Ottiene il numero di elementi. L'intervallo sottostante deve soddisfare sized_range.
Ereditato da view_interface	Descrizione
backC++20	Ottiene l'ultimo elemento.
emptyC++20	Verificare se la visualizzazione è vuota.
frontC++20	Ottenere il primo elemento.
operator boolC++20	Verificare se la visualizzazione non è vuota.
operator[]C++20	Ottiene l'elemento nella posizione specificata.

Requisiti

Intestazione: <ranges> (da C++20)

Spazio dei nomi: std::ranges

Opzione del compilatore: /std:c++20 o versione successiva è obbligatoria.

Costruttori

Costruire un'istanza di un oggetto transform_view

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

Parametri

base
Visualizzazione sottostante.

func
Funzione che trasforma ogni elemento.

Per informazioni sui tipi di parametri del modello, vedere Parametri del modello.

Valore restituito

Istanza di transform_view.

Osservazioni:

Il modo migliore per creare un transform_view oggetto consiste nell'usare l'adattatore views::transform di intervallo. Gli adattatori di intervallo sono il modo previsto per creare classi di visualizzazione. I tipi di visualizzazione vengono esposti nel caso in cui si voglia creare un tipo di visualizzazione personalizzato.

1) Creare un valore inizializzato transform_view. La funzione di trasformazione e la vista sottostante devono essere inizializzabili per impostazione predefinita.
2) Spostare costrutti transform_view da una base vista e una funzione funcdi trasformazione . Entrambi base e func vengono spostati tramite std::move().

Esempio: 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

Ottenere la visualizzazione sottostante.

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

Parametri

Nessuna.

Valori restituiti

Visualizzazione sottostante.

begin

Ottiene un iteratore al primo elemento nella visualizzazione.

constexpr auto begin();

Valore restituito

Iteratore che punta al primo elemento della visualizzazione. Il comportamento non è definito se la vista non ha un predicato.

end

Ottenere l'sentinel alla fine della visualizzazione.

constexpr auto end()

Valore restituito

Sentinel che segue l'ultimo elemento nella visualizzazione:

size

Ottiene il numero di elementi nella visualizzazione.

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

Parametri

Nessuna.

Valore restituito

Numero di elementi nella visualizzazione.

Vedi anche

<ranges>
filter adattatore di intervallo
classi di visualizzazione