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

CKTIS / C++

std::ranges::transform — transformar elementos en una salida

std::ranges::transform calcula valores a partir de un rango o de elementos correspondientes de dos rangos y los escribe mediante un iterador de salida. Es un algoritmo que actúa de inmediato, no una vista perezosa.

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

Sintaxis

#include <algorithm>
std::ranges::transform(r, out, op);
std::ranges::transform(r, out, op, proj);
std::ranges::transform(first, last, out, op, proj);
std::ranges::transform(r1, r2, out, binary_op);
std::ranges::transform(r1, r2, out, binary_op, proj1, proj2);
std::ranges::transform(first1, last1, first2, last2, out, binary_op, proj1, proj2);

std::ranges::transform de <algorithm> acepta rangos o pares de iterador y centinela. La forma unaria transforma cada elemento; la forma binaria combina los elementos correspondientes y se detiene al llegar al rango de entrada más corto. Las proyecciones opcionales proj, proj1, proj2 se aplican antes de la operación; de forma predeterminada, no modifican los argumentos.

La salida debe permitir escribir todos los resultados. El algoritmo no aumenta el tamaño de un contenedor: reserve() por sí solo no crea elementos. Proporciona elementos existentes o usa std::back_inserter con un contenedor adecuado. Se permite transformar en el mismo lugar cuando la salida empieza al principio de una entrada. La propia operación no debe modificar los elementos de los rangos ni invalidar iteradores.

El resultado expone las posiciones finales como .in y .out, o como .in1, .in2 y .out. Para un rango temporal que no sea un rango prestado, un campo de entrada puede tener el tipo std::ranges::dangling. Para N resultados escritos, la operación y cada proyección se invocan exactamente N veces.

A diferencia de la vista perezosa std::views::transform, este algoritmo escribe los resultados antes de regresar. Esta entrada describe el uso en C++23; el borrador de trabajo actual también contiene extensiones posteriores. Una opción del compilador en el repositorio no certifica la compatibilidad del entorno de ejecución de producción.

Ejemplos

#include <algorithm>
#include <array>
#include <iostream>

int main() {
    const std::array<int, 4> input{1, 2, 3, 4};
    std::array<int, 4> output{};

    auto result = std::ranges::transform(
        input, output.begin(), [](int x) { return x * x; });

    for (auto it = output.begin(); it != result.out; ++it) {
        if (it != output.begin()) std::cout << ' ';
        std::cout << *it;
    }
    std::cout << '\n';
}

Resultado

1 4 9 16

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