Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::views::all — vista de un rango completo

std::views::all adapta un rango a la interfaz de vista y conserva todos sus elementos. El resultado puede ser una copia o un movimiento de una vista existente, una vista de referencia o una vista propietaria; esta elección determina cómo gestionar la vida útil de los datos.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <ranges>
std::views::all(r)
r | std::views::all

std::views::all, declarado en <ranges>, es un objeto adaptador de rangos. Las expresiones std::views::all(r) y r | std::views::all producen una vista de todos los elementos, sin filtrar ni transformar sus valores. El argumento debe cumplir std::ranges::viewable_range.

La selección sigue un orden fijo: si el tipo del argumento, tras eliminar referencias y calificadores, modela std::ranges::view, el resultado es un objeto de ese tipo, copiado o movido según la categoría de valor. En caso contrario, se produce std::ranges::ref_view si se puede construir; si no, se produce std::ranges::owning_view. No todas las vistas se pueden pasar como lvalues: una vista que solo se puede mover puede requerir std::move.

Para un lvalue std::vector<int>, el resultado hace referencia al vector existente; para un std::vector<int> temporal, toma posesión del vector. Un ref_view no prolonga la vida útil de la fuente. La fuente debe seguir existiendo mientras se use la vista, y las reglas de invalidación de iteradores del contenedor siguen aplicándose. Si se pasa el vector como lvalue, all no copia los elementos. En cambio, si se pasa como lvalue una vista que se puede copiar, pueden copiarse tanto la vista como los elementos que almacena: una copia de std::ranges::single_view<int> almacena su propio int.

El ejemplo muestra ambos casos: escribir a través de borrowed modifica values, mientras que owned almacena su propio vector. La salida esperada son dos líneas que contienen 9. El repositorio usa la opción C++23; no se ha certificado la compatibilidad de ejecución en producción.

Ejemplos

#include <iostream>
#include <ranges>
#include <type_traits>
#include <vector>

int main() {
    std::vector<int> values{1, 2, 3};
    auto borrowed = values | std::views::all;
    auto owned = std::views::all(std::vector<int>{4, 5});

    static_assert(std::is_same_v<decltype(borrowed),
                  std::ranges::ref_view<std::vector<int>>>);
    static_assert(std::is_same_v<decltype(owned),
                  std::ranges::owning_view<std::vector<int>>>);

    borrowed.front() = 9;
    std::cout << values.front() << '\n';

    int sum = 0;
    for (int value : owned) {
        sum += value;
    }
    std::cout << sum << '\n';
}

Resultado

9
9

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes