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. |
base C++20 |
Ottenere l'intervallo sottostante. |
begin C++20 |
Ottenere un iteratore al primo elemento. |
end C++20 |
Ottenere l'sentinel alla fine della visualizzazione. |
size C++20 |
Ottiene il numero di elementi. L'intervallo sottostante deve soddisfare sized_range . |
Ereditato da view_interface |
Descrizione |
back C++20 |
Ottiene l'ultimo elemento. |
empty C++20 |
Verificare se la visualizzazione è vuota. |
front C++20 |
Ottenere il primo elemento. |
operator bool C++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 func
di 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