CKTIS / C++
std::ranges::transform — transformace prvků do výstupu
std::ranges::transform počítá hodnoty z jednoho rozsahu nebo z odpovídajících prvků dvou rozsahů a zapisuje je pomocí výstupního iterátoru. Jde o okamžitě prováděný algoritmus, nikoli o líný pohled.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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> přijímá rozsahy nebo dvojice iterátor–sentinel. Unární forma transformuje každý prvek; binární forma kombinuje odpovídající prvky a končí na kratším vstupním rozsahu. Volitelné projekce proj, proj1, proj2 se použijí před operací; ve výchozím nastavení argumenty nemění.
Výstup musí umožňovat zápis všech výsledků. Algoritmus kontejner nezvětšuje: samotné reserve() žádné prvky nevytvoří. Zajistěte existující prvky nebo použijte std::back_inserter s vhodným kontejnerem. Transformace na místě je povolena, pokud výstup začíná na začátku jednoho ze vstupů. Samotná operace nesmí měnit prvky rozsahu ani zneplatnit iterátory.
Výsledek zpřístupňuje koncové pozice jako .in a .out, nebo jako .in1, .in2 a .out. U dočasného rozsahu, který není borrowed range, může mít vstupní pole typ std::ranges::dangling. Pro N zapsaných výsledků se operace i každá projekce zavolají přesně Nkrát.
Na rozdíl od líného pohledu std::views::transform tento algoritmus zapíše výsledky před návratem. Tento záznam popisuje použití v C++23; aktuální pracovní návrh obsahuje také pozdější rozšíření. Příznak kompilátoru v repozitáři nepotvrzuje kompatibilitu produkčního běhového prostředí.
Pří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ýsledek
1 4 9 16
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.