Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::transform — trasformare gli elementi di un intervallo

std::transform di <algorithm> scrive i risultati di un’operazione unaria o binaria in un intervallo di output. Non crea un contenitore e non ne aumenta automaticamente la dimensione.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

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

std::transform di <algorithm> elabora l’intervallo semiaperto [first1, last1). La forma unaria applica op a ogni elemento; quella binaria applica binary_op agli elementi corrispondenti di due intervalli. Scrive i risultati a partire da result e restituisce l’iteratore successivo all’ultimo elemento scritto.

Con N elementi nel primo intervallo, l’operazione viene chiamata esattamente N volte. La forma binaria classica non accetta un iteratore finale per il secondo intervallo: questo deve contenere almeno N elementi accessibili. Anche l’output deve consentire N scritture. La sola chiamata a reserve() non crea elementi; per scrivere tramite begin(), il contenitore deve avere una dimensione adeguata.

La trasformazione sul posto è consentita quando result == first1 oppure, per la forma binaria, result == first2. L’operazione stessa non deve modificare elementi degli intervalli elaborati né invalidare iteratori. Non fare affidamento sull’ordine delle chiamate; la soluzione più semplice è restituire un risultato senza effetti collaterali.

L’esempio mostra entrambe le forme senza una politica di esecuzione. Questa voce riguarda C++23; la bozza dello standard fornita è un documento in evoluzione e contiene anche estensioni successive che l’esempio non usa.

Esempi

#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';
}

Risultato

1 4 9
2 6 12

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.

Fonti