CKTIS / C++
std::transform — transformácia prvkov rozsahu
std::transform z <algorithm> zapisuje výsledky unárnej alebo binárnej operácie do výstupného rozsahu. Nevytvára kontajner ani automaticky nezväčšuje jeho veľkosť.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <algorithm>
std::transform(first1, last1, result, op);
std::transform(first1, last1, first2, result, binary_op);std::transform z <algorithm> spracúva polootvorený rozsah [first1, last1). Unárna forma aplikuje op na každý prvok; binárna forma aplikuje binary_op na zodpovedajúce prvky dvoch rozsahov. Výsledky zapisuje od result a vracia iterátor za posledným zapísaným prvkom.
Pre N prvkov v prvom rozsahu vykoná presne N volaní operácie. Klasická binárna forma neprijíma koncový iterátor druhého rozsahu: ten musí obsahovať aspoň N dostupných prvkov. Výstup musí tiež umožňovať N zápisov. Samotné zavolanie reserve() prvky nevytvorí; na zápis cez begin() musí mať kontajner dostatočnú veľkosť.
Transformácia na mieste je povolená, keď platí result == first1 alebo pri binárnej forme result == first2. Samotná operácia nesmie meniť prvky spracúvaných rozsahov ani zneplatňovať iterátory. Nespoliehajte sa na poradie jej volaní; najjednoduchšie je vracať výsledok bez vedľajších účinkov.
Príklad ukazuje obe formy bez politiky vykonávania. Tento záznam sa vzťahuje na C++23; dodaný návrh štandardu je priebežne aktualizovaný dokument a obsahuje aj neskoršie rozšírenia, ktoré príklad nepoužíva.
Príklady
#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';
}
Výsledok
1 4 9 2 6 12
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.