CKTIS / C++
std::ranges::transform — pretvorba elementov v izhodni zapis
std::ranges::transform izračuna vrednosti iz enega območja ali iz ustreznih elementov dveh območij in jih zapiše prek izhodnega iteratorja. Algoritem izvede delo takoj in ni len pogled.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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 iz <algorithm> sprejema območja ali pare iterator–sentinel. Unarna oblika pretvori vsak element; binarna oblika združi ustrezne elemente in se konča pri krajšem vhodnem območju. Izbirne projekcije proj, proj1, proj2 se uporabijo pred operacijo; privzeto argumentov ne spremenijo.
Izhod mora omogočati zapis vseh rezultatov. Algoritem vsebnika ne poveča: sam reserve() ne ustvari elementov. Zagotovite obstoječe elemente ali uporabite std::back_inserter z ustreznim vsebnikom. Pretvorba na mestu je dovoljena, kadar se izhod začne na začetku enega od vhodov. Sama operacija ne sme spreminjati elementov območij ali razveljaviti iteratorjev.
Rezultat razkrije končne položaje kot .in in .out ali kot .in1, .in2 in .out. Pri začasnem območju, ki ni borrowed range, je lahko vhodno polje tipa std::ranges::dangling. Za N zapisanih rezultatov se operacija in vsaka projekcija pokličeta natanko N-krat.
V nasprotju z lenim pogledom std::views::transform ta algoritem zapiše rezultate, preden se vrne. Ta vnos opisuje uporabo v C++23; trenutni delovni osnutek vsebuje tudi poznejše razširitve. Zastavica prevajalnika v repozitoriju ne potrjuje združljivosti produkcijskega izvajalnega okolja.
Primeri
#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';
}
Rezultat
1 4 9 16
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.