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

CKTIS / C++

std::transform — transformar elementos de um intervalo

std::transform de <algorithm> escreve os resultados de uma operação unária ou binária num intervalo de saída. Não cria um contentor nem aumenta automaticamente o seu tamanho.

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

Sintaxe

#include <algorithm>
std::transform(first1, last1, result, op);
std::transform(first1, last1, first2, result, binary_op);

std::transform de <algorithm> processa o intervalo semiaberto [first1, last1). A forma unária aplica op a cada elemento; a forma binária aplica binary_op aos elementos correspondentes de dois intervalos. Escreve os resultados a partir de result e devolve o iterador a seguir ao último elemento escrito.

Para N elementos no primeiro intervalo, executa exatamente N chamadas à operação. A forma binária clássica não recebe um iterador final para o segundo intervalo: este tem de conter pelo menos N elementos acessíveis. A saída também tem de permitir N escritas. Chamar apenas reserve() não cria elementos; para escrever através de begin(), o contentor tem de ter um tamanho adequado.

A transformação no próprio local é permitida quando result == first1 ou, na forma binária, result == first2. A operação não pode modificar elementos dos intervalos processados nem invalidar iteradores. Não dependa da ordem das chamadas; o mais simples é devolver um resultado sem efeitos secundários.

O exemplo demonstra ambas as formas sem uma política de execução. Esta entrada destina-se a C++23; o projeto de norma fornecido é um documento em evolução e contém também extensões posteriores que o exemplo não utiliza.

Exemplos

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

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

    std::transform(input.begin(), input.end(), squared.begin(),
                   [](int x) { return x * x; });
    std::transform(input.begin(), input.end(), squared.begin(), sums.begin(),
                   [](int x, int y) { return x + y; });

    std::cout << squared[0] << ' ' << squared[1] << ' ' << squared[2] << '\n';
    std::cout << sums[0] << ' ' << sums[1] << ' ' << sums[2] << '\n';
}

Resultado

1 4 9
2 6 12

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