Namespaces
Variants

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

From cppreference.net
C++
Ranges library
Range adaptors
std::ranges::transform_view
Member functions
(C++26)
Deduction guides
Iterator
Sentinel
Definiert im Header <ranges>
(1)
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>>& ist ein gültiger Typ */
class transform_view

: public ranges:: view_interface < transform_view < V, F >>
(seit C++20)
(bis C++23)
template < ranges:: input_range V,

std:: move_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>>& ist ein gültiger Typ */
class transform_view

: public ranges:: view_interface < transform_view < V, F >>
(seit C++23)
namespace views {

inline constexpr /*unspezifiziert*/ transform = /*unspezifiziert*/ ;

}
(2) (seit C++20)
Aufrufsignatur
template < ranges:: viewable_range R, class F >

requires /* siehe unten */

constexpr ranges:: view auto transform ( R && r, F && fun ) ;
(seit C++20)
template < class F >
constexpr /*Range-Adapter-Closure*/ transform ( F && fun ) ;
(seit C++20)
1) Ein Bereichsadapter, der eine view einer zugrundeliegenden Sequenz darstellt, nachdem eine Transformationsfunktion auf jedes Element angewendet wurde.
2) RangeAdaptorObject . Der Ausdruck views :: transform ( e, f ) ist ausdrucksäquivalent zu transform_view ( e, f ) für beliebige geeignete Teilausdrücke e und f .

transform_view modelliert die Konzepte random_access_range , bidirectional_range , forward_range , input_range , common_range und sized_range , wenn die zugrundeliegende View V die jeweiligen Konzepte modelliert.

Inhaltsverzeichnis

Datenmitglieder

Member Beschreibung
V base_ (privat) die zugrundeliegende Ansicht
( Nur zur Darstellung verwendetes Member-Objekt* )
copyable-box <F> (bis C++23) movable-box <F> (seit C++23) fun_ (privat) das zugrundeliegende Funktionsobjekt
( Nur zur Darstellung verwendetes Member-Objekt* )

Memberfunktionen

konstruiert einen transform_view
(öffentliche Elementfunktion)
gibt eine Kopie der zugrunde liegenden (adaptierten) Ansicht zurück
(öffentliche Elementfunktion)
gibt einen Iterator zum Anfang zurück
(öffentliche Elementfunktion)
gibt einen Iterator oder Sentinel zum Ende zurück
(öffentliche Elementfunktion)
gibt die Anzahl der Elemente zurück, bereitgestellt nur wenn der zugrunde liegende (adaptierte) Bereich sized_range erfüllt
(öffentliche Elementfunktion)
(C++26)
gibt die ungefähre Größe des resultierenden approximately_sized_range zurück
(öffentliche Elementfunktion)
Geerbt von std::ranges::view_interface
gibt zurück, ob die abgeleitete Ansicht leer ist, bereitgestellt nur wenn sie sized_range oder forward_range erfüllt
(öffentliche Elementfunktion von std::ranges::view_interface<D> )
(C++23)
gibt einen konstanten Iterator zum Anfang des Bereichs zurück
(öffentliche Elementfunktion von std::ranges::view_interface<D> )
(C++23)
gibt einen Sentinel für den konstanten Iterator des Bereichs zurück
(öffentliche Elementfunktion von std::ranges::view_interface<D> )
gibt zurück, ob die abgeleitete Ansicht nicht leer ist, bereitgestellt nur wenn ranges::empty darauf anwendbar ist
(öffentliche Elementfunktion von std::ranges::view_interface<D> )
gibt das erste Element in der abgeleiteten Ansicht zurück, bereitgestellt wenn sie forward_range erfüllt
(öffentliche Elementfunktion von std::ranges::view_interface<D> )
gibt das letzte Element in der abgeleiteten Ansicht zurück, bereitgestellt nur wenn sie bidirectional_range und common_range erfüllt
(öffentliche Elementfunktion von std::ranges::view_interface<D> )
gibt das n te Element in der abgeleiteten Ansicht zurück, bereitgestellt nur wenn sie random_access_range erfüllt
(öffentliche Elementfunktion von std::ranges::view_interface<D> )

Ableitungsleitfäden

Geschachtelte Klassen

der Iteratortyp
( Nur zur Darstellung dienende Member-Klassenvorlage* )
der Sentineltyp
( Nur zur Darstellung dienende Member-Klassenvorlage* )

Beispiel

Diesen Code ausführen 
#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.net\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);
}

Ausgabe: 

cppreference.net
pccersrerapr.pbz
pccersrerapr.pbz
cppreference.net

Siehe auch

(C++20)
wendet eine Funktion auf einen Bereich von Elementen an
(Algorithmus-Funktionsobjekt)