CKTIS / C++
std::ranges::transform — Elemente in eine Ausgabe umwandeln
std::ranges::transform berechnet Werte aus einem Bereich oder aus entsprechenden Elementen zweier Bereiche und schreibt sie über einen Ausgabeiterator. Der Algorithmus arbeitet sofort und ist keine verzögerte View.
Version: 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 aus <algorithm> akzeptiert Bereiche oder Iterator-Sentinel-Paare. Die unäre Form wandelt jedes Element um; die binäre Form kombiniert entsprechende Elemente und endet beim kürzeren Eingabebereich. Optionale Projektionen proj, proj1, proj2 werden vor der Operation angewendet; standardmäßig verändern sie die Argumente nicht.
Die Ausgabe muss das Schreiben aller Ergebnisse ermöglichen. Der Algorithmus vergrößert keinen Container: reserve() allein erzeugt keine Elemente. Stelle vorhandene Elemente bereit oder verwende std::back_inserter mit einem geeigneten Container. Eine Umwandlung an Ort und Stelle ist erlaubt, wenn die Ausgabe am Anfang einer Eingabe beginnt. Die Operation selbst darf weder Bereichselemente ändern noch Iteratoren ungültig machen.
Das Ergebnis stellt die Endpositionen als .in und .out oder als .in1, .in2 und .out bereit. Bei einem temporären Bereich, der kein Borrowed Range ist, kann ein Eingabefeld den Typ std::ranges::dangling haben. Bei N geschriebenen Ergebnissen werden die Operation und jede Projektion genau N-mal aufgerufen.
Anders als die verzögerte std::views::transform schreibt dieser Algorithmus die Ergebnisse, bevor er zurückkehrt. Dieser Eintrag beschreibt die Verwendung in C++23; der aktuelle Arbeitsentwurf enthält auch spätere Erweiterungen. Ein Compiler-Flag im Repository bestätigt nicht die Kompatibilität der Produktionslaufzeit.
Beispiele
#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';
}
Ergebnis
1 4 9 16
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.