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.