Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::ranges::transform — transformar elementos numa saída

std::ranges::transform calcula valores a partir de um intervalo ou de elementos correspondentes de dois intervalos e escreve-os através de um iterador de saída. É um algoritmo imediato, não uma vista diferida.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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> aceita intervalos ou pares iterador-sentinela. A forma unária transforma cada elemento; a forma binária combina elementos correspondentes e termina no intervalo de entrada mais curto. As projeções opcionais proj, proj1, proj2 são aplicadas antes da operação; por predefinição, não alteram os argumentos.

A saída tem de permitir escrever todos os resultados. O algoritmo não aumenta o tamanho de um contentor: reserve() por si só não cria elementos. Disponibilize elementos existentes ou utilize std::back_inserter com um contentor adequado. É permitido transformar no próprio local quando a saída começa no início de uma entrada. A operação em si não pode modificar os elementos dos intervalos nem invalidar iteradores.

O resultado expõe as posições finais como .in e .out, ou .in1, .in2 e .out. Para um intervalo temporário que não seja um intervalo emprestado, um campo de entrada pode ter o tipo std::ranges::dangling. Para N resultados escritos, a operação e cada projeção são invocadas exatamente N vezes.

Ao contrário da vista diferida std::views::transform, este algoritmo escreve os resultados antes de devolver o controlo. Esta entrada descreve a utilização em C++23; o atual projeto de trabalho também inclui extensões posteriores. Uma opção do compilador no repositório não atesta a compatibilidade do ambiente de execução de produção.

Exemplos

#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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes