Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti