Namespaces
Variants

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

From cppreference.net
Ranges library
Range adaptors
Definido en el encabezado <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>>& es un tipo válido */
class transform_view

: public ranges:: view_interface < transform_view < V, F >>
(desde C++20)
(hasta 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>>& es un tipo válido */
class transform_view

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

inline constexpr /*no especificado*/ transform = /*no especificado*/ ;

}
(2) (desde C++20)
Firma de llamada
template < ranges:: viewable_range R, class F >

requires /* ver más abajo */

constexpr ranges:: view auto transform ( R && r, F && fun ) ;
(desde C++20)
template < class F >
constexpr /*adaptador de rango de cierre*/ transform ( F && fun ) ;
(desde C++20)
1) Un adaptador de rango que representa una view de una secuencia subyacente después de aplicar una función de transformación a cada elemento.
2) RangeAdaptorObject . La expresión views :: transform ( e, f ) es equivalente-expresión a transform_view ( e, f ) para cualesquiera subexpresiones adecuadas e y f .

transform_view modela los conceptos random_access_range , bidirectional_range , forward_range , input_range , common_range , y sized_range cuando la vista subyacente V modela los respectivos conceptos.

Contenidos

Miembros de datos

Miembro Descripción
V base_ (privado) la vista subyacente
( objeto miembro solo para exposición* )
copyable-box <F> (hasta C++23) movable-box <F> (desde C++23) fun_ (privado) el objeto función subyacente
( objeto miembro solo para exposición* )

Funciones miembro

construye un transform_view
(función miembro pública)
devuelve una copia de la vista subyacente (adaptada)
(función miembro pública)
devuelve un iterador al inicio
(función miembro pública)
devuelve un iterador o un centinela al final
(función miembro pública)
devuelve el número de elementos, proporcionado solo si el rango subyacente (adaptado) satisface sized_range
(función miembro pública)
devuelve el tamaño aproximado del approximately_sized_range resultante
(función miembro pública)
Heredado de std::ranges::view_interface
devuelve si la vista derivada está vacía, proporcionado solo si satisface sized_range o forward_range
(función miembro pública de std::ranges::view_interface<D> )
(C++23)
devuelve un iterador constante al inicio del rango
(función miembro pública de std::ranges::view_interface<D> )
(C++23)
devuelve un centinela para el iterador constante del rango
(función miembro pública de std::ranges::view_interface<D> )
devuelve si la vista derivada no está vacía, proporcionado solo si ranges::empty es aplicable a ella
(función miembro pública de std::ranges::view_interface<D> )
devuelve el primer elemento en la vista derivada, proporcionado si satisface forward_range
(función miembro pública de std::ranges::view_interface<D> )
devuelve el último elemento en la vista derivada, proporcionado solo si satisface bidirectional_range y common_range
(función miembro pública de std::ranges::view_interface<D> )
devuelve el n th elemento en la vista derivada, proporcionado solo si satisface random_access_range
(función miembro pública de std::ranges::view_interface<D> )

Guías de deducción

Clases anidadas

el tipo de iterador
( clase de plantilla miembro solo para exposición* )
el tipo de centinela
( clase de plantilla miembro solo para exposición* )

Ejemplo

#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);
}

Salida:

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

Véase también

aplica una función a un rango de elementos
(objeto función de algoritmo)