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.