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

CKTIS / C++

std::ranges::to — construir un contenedor a partir de un rango

C++23 std::ranges::to construye un objeto, normalmente un contenedor, a partir de un rango de entrada. Permite terminar una canalización de vistas con un resultado concreto, indicando el tipo completo del contenedor o una plantilla cuyos argumentos se deducirán.

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

Sintaxis

std::ranges::to<C>(range, args...)
range | std::ranges::to<C>(args...)
std::ranges::to<ContainerTemplate>(range, args...)
range | std::ranges::to<ContainerTemplate>(args...)

std::ranges::to, disponible desde C++23 en <ranges>, construye un resultado a partir de un rango que satisface input_range. Para un contenedor como std::vector<int>, materializa los elementos en lugar de crear otra vista perezosa. El tipo de destino C debe ser un tipo de clase sin calificadores cv y no debe satisfacer view.

La expresión std::ranges::to<std::vector<int>>(range) especifica explícitamente el tipo del resultado. La forma std::ranges::to<std::vector>(range) utiliza la deducción de argumentos de plantilla de clase. En una canalización, usa range | std::ranges::to<std::vector<int>>(): los () crean un objeto de cierre de canalización. Los args... adicionales, como un asignador, se reenvían al constructor de contenedor seleccionado.

Para elementos directamente convertibles, la función prueba, en este orden: un constructor que acepte el rango, un constructor etiquetado con std::from_range, un constructor adecuado que reciba un par de iteradores y, por último, la construcción con args... seguida de la inserción de elementos. Cada vía tiene sus propios requisitos. Los rangos anidados pueden convertirse recursivamente; si no se aplica ninguna vía permitida, el programa está mal formado.

El ejemplo construye un std::vector<int> con los cuadrados de 1 a 5; el límite superior de std::views::iota(1, 6) es exclusivo. Materializar esta canalización recorre sus elementos, así que no uses un rango ilimitado sin limitar la cantidad de elementos. Se necesita una implementación de biblioteca que admita esta característica de C++23: la opción de compilación del repositorio por sí sola no acredita la compatibilidad en producción. La referencia proporcionada es un borrador de norma en desarrollo, no una edición fija de C++23.

Ejemplos

#include <cstddef>
#include <iostream>
#include <ranges>
#include <vector>

int main() {
    auto values = std::views::iota(1, 6)
        | std::views::transform([](int n) { return n * n; })
        | std::ranges::to<std::vector<int>>();

    for (std::size_t i = 0; i < values.size(); ++i) {
        if (i != 0) std::cout << ' ';
        std::cout << values[i];
    }
    std::cout << '\n';
}

Resultado

1 4 9 16 25

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