CKTIS / C++
std::transform — transformace prvků rozsahu
std::transform z <algorithm> zapisuje výsledky unární nebo binární operace do výstupního rozsahu. Nevytváří kontejner ani automaticky nezvětšuje jeho velikost.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <algorithm>
std::transform(first1, last1, result, op);
std::transform(first1, last1, first2, result, binary_op);std::transform z <algorithm> zpracovává polootevřený rozsah [first1, last1). Unární forma aplikuje op na každý prvek; binární forma aplikuje binary_op na odpovídající prvky dvou rozsahů. Výsledky zapisuje od result a vrací iterátor za posledním zapsaným prvkem.
Pro N prvků v prvním rozsahu provede přesně N volání operace. Klasická binární forma nepřijímá koncový iterátor druhého rozsahu: ten musí obsahovat alespoň N přístupných prvků. Výstup musí rovněž umožňovat N zápisů. Samotné zavolání reserve() prvky nevytvoří; pro zápis přes begin() musí mít kontejner dostatečnou velikost.
Transformace na místě je povolena, když platí result == first1 nebo u binární formy result == first2. Samotná operace nesmí měnit prvky zpracovávaných rozsahů ani zneplatňovat iterátory. Nespoléhejte na pořadí jejích volání; nejjednodušší je vracet výsledek bez vedlejších účinků.
Příklad ukazuje obě formy bez zásad provádění. Tento záznam cílí na C++23; dodaný návrh standardu je průběžně aktualizovaný dokument a obsahuje také pozdější rozšíření, která příklad nepoužívá.
Pří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ýsledek
1 4 9 2 6 12
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.