Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::transform — pretvarjanje elementov obsega

std::transform iz <algorithm> zapiše rezultate unarne ali binarne operacije v izhodni obseg. Ne ustvari vsebnika in samodejno ne poveča njegove velikosti.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

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

std::transform iz <algorithm> obdela polodprti obseg [first1, last1). Unarna oblika uporabi op za vsak element; binarna oblika uporabi binary_op za ustrezne elemente dveh obsegov. Rezultate zapiše od result naprej in vrne iterator za zadnjim zapisanim elementom.

Za N elementov v prvem obsegu izvede natanko N klicev operacije. Klasična binarna oblika ne prejme končnega iteratorja za drugi obseg: ta mora vsebovati vsaj N dostopnih elementov. Tudi izhod mora omogočati N zapisov. Sam klic reserve() ne ustvari elementov; za zapis prek begin() mora biti vsebnik ustrezno velik.

Pretvarjanje na mestu je dovoljeno, kadar velja result == first1 ali pri binarni obliki result == first2. Operacija sama ne sme spreminjati elementov obdelanih obsegov ali razveljaviti iteratorjev. Ne zanašajte se na vrstni red njenih klicev; najpreprosteje je vrniti rezultat brez stranskih učinkov.

Primer prikazuje obe obliki brez izvajalne politike. Ta vnos je namenjen C++23; priloženi osnutek standarda je dokument, ki se sproti dopolnjuje, in vsebuje tudi poznejše razširitve, ki jih primer ne uporablja.

Primeri

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

Rezultat

1 4 9
2 6 12

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri