CKTIS / C++
std::ranges::transform — transformácia prvkov do výstupu
std::ranges::transform počíta hodnoty z jedného rozsahu alebo zodpovedajúcich prvkov dvoch rozsahov a zapisuje ich pomocou výstupného iterátora. Je to algoritmus vykonávajúci prácu okamžite, nie lenivý pohľad.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#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 z <algorithm> prijíma rozsahy alebo dvojice iterátor–sentinel. Unárna forma transformuje každý prvok; binárna forma kombinuje zodpovedajúce prvky a končí na kratšom vstupnom rozsahu. Voliteľné projekcie proj, proj1, proj2 sa použijú pred operáciou; predvolene argumenty nemenia.
Výstup musí umožňovať zápis všetkých výsledkov. Algoritmus kontajner nezväčšuje: samotné reserve() nevytvorí žiadne prvky. Zabezpečte existujúce prvky alebo použite std::back_inserter s vhodným kontajnerom. Transformácia na mieste je povolená, ak výstup začína na začiatku jedného zo vstupov. Samotná operácia nesmie meniť prvky rozsahu ani zneplatniť iterátory.
Výsledok sprístupňuje koncové pozície ako .in a .out, alebo ako .in1, .in2 a .out. Pri dočasnom rozsahu, ktorý nie je borrowed range, môže mať vstupné pole typ std::ranges::dangling. Pre N zapísaných výsledkov sa operácia aj každá projekcia zavolajú presne N-krát.
Na rozdiel od lenivého pohľadu std::views::transform tento algoritmus zapíše výsledky pred návratom. Tento záznam opisuje použitie v C++23; aktuálny pracovný návrh obsahuje aj neskoršie rozšírenia. Príznak kompilátora v repozitári nepotvrdzuje kompatibilitu produkčného runtime prostredia.
Príklady
#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';
}
Výsledok
1 4 9 16
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.