std::ranges::views::as_rvalue, std::ranges::as_rvalue_view

Definido en el encabezado `<ranges>`
template< ranges::view V > requires ranges::input_range<V> class as_rvalue_view : public ranges::view_interface<as_rvalue_view<V>>	(1)	(desde C++23)
namespace views { inline constexpr /* unspecified / as_rvalue = / unspecified */; }	(2)	(desde C++23)
Firma de llamada
template< ranges::viewable_range R > requires /* see below */ constexpr ranges::view auto as_rvalue( R&& r );		(desde C++23)

1) Un adaptador de rango que representa una vista de la vista subyacente cuyos elementos son valores r.

2) RangeAdaptorObject. Sea e una subexpresión y sea T que es decltype((e)). Entonces la expresión views::as_rvalue(e) es equivalente en expresión a:

views::all(e), si es una expresión bien formada, T modela input_range, y std::same_as<ranges::range_rvalue_reference_t<T>, ranges::range_reference_t<T>> es true;
as_rvalue_view{e} en caso contrario.

Miembros de datos

Miembro	Descripción
`V` `base_` (privado)	la vista subyacente ( objeto miembro solo para exposición* )

Funciones miembro

(constructor)	construye un `as_rvalue_view` (función miembro pública)
base	devuelve la vista subyacente `V` (función miembro pública)
begin	devuelve el iterador inicial del `as_rvalue_view` (función miembro pública)
end	devuelve el iterador final del `as_rvalue_view` (función miembro pública)
size	devuelve el tamaño de la vista si está acotada (función miembro pública)
reserve_hint (C++26)	devuelve el tamaño aproximado del `approximately_sized_range` subyacente (función miembro pública)
Heredado de ranges::view_interface
empty	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>`)
cbegin (C++23)	devuelve un iterador constante al inicio del rango (función miembro pública de `std::ranges::view_interface<D>`)
cend (C++23)	devuelve un centinela para el iterador constante del rango (función miembro pública de `std::ranges::view_interface<D>`)
operator bool	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>`)
front	devuelve el primer elemento en la vista derivada, proporcionado si satisface `forward_range` (función miembro pública de `std::ranges::view_interface<D>`)
back	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>`)
operator[]	devuelve el `n`^ésimo elemento en la vista derivada, proporcionado solo si satisface `random_access_range` (función miembro pública de `std::ranges::view_interface<D>`)

std::ranges::as_rvalue_view:: as_rvalue_view

as_rvalue_view ( ) requires std:: default_initializable < V > = default ;	(1)	(desde C++23)
constexpr explicit as_rvalue_view ( V base ) ;	(2)	(desde C++23)

1) Inicializa por valor




           base_

mediante su inicializador de miembro predeterminado ( = V ( ) ).

2) Inicializa




           base_

con std :: move ( base ) .

Parámetros

base

-

una vista

std::ranges::as_rvalue_view:: base

constexpr V base ( ) const & requires std:: copy_constructible < V > ;	(1)	(desde C++23)
constexpr V base ( ) && ;	(2)	(desde C++23)

Devuelve la vista subyacente.

1) Construye por copia el resultado desde la vista subyacente. Equivalente a return




            base_

; .

2) Construye por movimiento el resultado desde la vista subyacente. Equivalente a return std :: move (




            base_

) ; .

std::ranges::as_rvalue_view:: begin

constexpr auto begin ( ) requires ( ! /simple-view/ < V > ) ;	(1)	(desde C++23)
constexpr auto begin ( ) const requires ranges:: range < const V > ;	(2)	(desde C++23)

Devuelve std:: move_iterator ( ranges:: begin ( base_ ) ) .

std::ranges::as_rvalue_view:: end

constexpr auto end ( ) requires ( ! /simple-view/ < V > ) ;	(1)	(desde C++23)
constexpr auto end ( ) const requires ranges:: range < const V > ;	(2)	(desde C++23)

Devuelve std:: move_iterator ( ranges:: end ( base_ ) ) si (1) V o (2) const V modela common_range .

Devuelve std:: move_sentinel ( ranges:: end ( base_ ) ) en caso contrario.

std::ranges::as_rvalue_view:: size

constexpr auto size ( ) requires ranges:: sized_range < V > ;	(1)	(desde C++23)
constexpr auto size ( ) const requires ranges:: sized_range < const V > ;	(2)	(desde C++23)

Devuelve el tamaño de la vista si la vista está acotada. Equivalente a return ranges:: size ( base_ ) ; .

std::ranges::as_rvalue_view:: reserve_hint

constexpr auto reserve_hint ( ) requires ranges :: approximately_sized_range < V > ;	(1)	(desde C++26)
constexpr auto reserve_hint ( ) const requires ranges :: approximately_sized_range < const V > ;	(2)	(desde C++26)

Devuelve ranges :: reserve_hint ( base_ ) .

Guías de deducción

template < class R > as_rvalue_view ( R && ) - > as_rvalue_view < views:: all_t < R >> ;		(desde C++23)

Plantillas auxiliares

template < class T > constexpr bool enable_borrowed_range < std :: ranges :: as_rvalue_view < T >> = ranges:: enable_borrowed_range < T > ;		(desde C++23)

Esta especialización de ranges::enable_borrowed_range hace que as_rvalue_view satisfaga borrowed_range cuando la vista subyacente lo satisface.

Notas

Macro de prueba de características	Valor	Estándar	Característica
`__cpp_lib_ranges_as_rvalue`	`202207L`	(C++23)	`std::ranges::as_rvalue_view`
`__cpp_lib_ranges_reserve_hint`	`202502L`	(C++26)	ranges::approximately_sized_range y `reserve_hint`

Ejemplo

Ejecutar este código

#include <algorithm>
#include <iostream>
#include <ranges>
#include <string>
#include <vector>
int main()
{
    std::vector<std::string> words =
        {"Quick", "red", "\N{FOX FACE}", "jumped", "over", "a", "pterodactyl"};
    std::vector<std::string> new_words;
    std::ranges::copy(
        words | std::views::as_rvalue,
        std::back_inserter(new_words)); // mover cadenas desde words hacia new_words
    auto quoted = std::views::transform([](auto&& s) { return "“" + s + "”"; });
    std::cout << "Palabras antiguas: ";
    for (auto&& word : words | std::views::as_rvalue | quoted)
        std::cout << word << ' ';
    std::cout << "\nPalabras nuevas: ";
    for (auto&& word : new_words | std::views::as_rvalue | quoted)
        std::cout << word << ' ';
}

Salida posible:

Palabras antiguas: “” “” “” “” “” “” “” 
Palabras nuevas: “Quick” “red” “🦊” “jumped” “over” “a” “pterodactyl”

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

DR	Aplicado a	Comportamiento publicado	Comportamiento correcto
LWG 4083	C++23	`views::as_rvalue` solía aceptar rangos no de entrada	se hizo rechazado

Véase también

iter_move (C++20)	convierte el resultado de desreferenciar un objeto a su tipo de referencia de valor asociado (objeto de punto de personalización)
move_iterator (C++11)	adaptador de iterador que se desreferencia a un valor r (plantilla de clase)
move_sentinel (C++20)	adaptador de centinela para std::move_iterator (plantilla de clase)
ranges::as_const_view views::as_const (C++23)	convierte una `view` en un `constant_range` (plantilla de clase) (objeto adaptador de rango)

Soporte del compilador
Independiente y alojado
Lenguaje
Biblioteca estándar
Encabezados de la biblioteca estándar
Requisitos nombrados
Macros de prueba de características (C++20)
Biblioteca de soporte del lenguaje
Biblioteca de conceptos (C++20)
Biblioteca de diagnóstico
Biblioteca de gestión de memoria
Biblioteca de metaprogramación (C++11)
Biblioteca de utilidades generales
Biblioteca de contenedores
Biblioteca de iteradores
Biblioteca de rangos (C++20)
Biblioteca de algoritmos
Biblioteca de cadenas
Biblioteca de procesamiento de texto
Biblioteca numérica
Biblioteca de fecha y hora
Biblioteca de entrada/salida
Biblioteca del sistema de archivos (C++17)
Biblioteca de soporte de concurrencia (C++11)
Biblioteca de control de ejecución (C++26)
Especificaciones técnicas
Índice de símbolos
Bibliotecas externas

es.cppreference.net

Namespaces

Variants