CKTIS / C++
std::ranges::transform — trasformare elementi in un output
std::ranges::transform calcola valori da un intervallo o da elementi corrispondenti di due intervalli e li scrive tramite un iteratore di output. È un algoritmo immediato, non una view lazy.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#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 di <algorithm> accetta intervalli o coppie iteratore-sentinella. La forma unaria trasforma ogni elemento; quella binaria combina gli elementi corrispondenti e si ferma all’intervallo di input più corto. Le proiezioni facoltative proj, proj1, proj2 vengono applicate prima dell’operazione; per impostazione predefinita non modificano gli argomenti.
L’output deve consentire la scrittura di tutti i risultati. L’algoritmo non ingrandisce un contenitore: reserve() da solo non crea elementi. Fornisci elementi già esistenti oppure usa std::back_inserter con un contenitore adatto. La trasformazione sul posto è consentita quando l’output inizia dall’inizio di un input. L’operazione stessa non deve modificare gli elementi degli intervalli né invalidare gli iteratori.
Il risultato espone le posizioni finali come .in e .out, oppure .in1, .in2 e .out. Per un intervallo temporaneo che non è un intervallo borrowed, un campo di input può essere di tipo std::ranges::dangling. Per N risultati scritti, l’operazione e ciascuna proiezione vengono chiamate esattamente N volte.
A differenza della view lazy std::views::transform, questo algoritmo scrive i risultati prima di restituire il controllo. Questa voce descrive l’uso in C++23; l’attuale working draft include anche estensioni successive. Un’opzione del compilatore nel repository non attesta la compatibilità dell’ambiente di esecuzione di produzione.
Esempi
#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';
}
Risultato
1 4 9 16
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.