WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::transform — Bereichselemente transformieren

std::transform aus <algorithm> schreibt die Ergebnisse einer unären oder binären Operation in einen Ausgabebereich. Es erstellt weder einen Container noch vergrößert es automatisch dessen Größe.

Version: 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 aus <algorithm> verarbeitet den halboffenen Bereich [first1, last1). Die unäre Form wendet op auf jedes Element an; die binäre Form wendet binary_op auf entsprechende Elemente aus zwei Bereichen an. Die Ergebnisse werden ab result geschrieben; zurückgegeben wird der Iterator hinter dem zuletzt geschriebenen Element.

Bei N Elementen im ersten Bereich wird die Operation genau N-mal aufgerufen. Die klassische binäre Form erhält keinen Enditerator für den zweiten Bereich: Dieser muss mindestens N zugängliche Elemente enthalten. Auch der Ausgabebereich muss N Schreibvorgänge erlauben. Ein Aufruf von reserve() allein erzeugt keine Elemente; zum Schreiben über begin() muss der Container ausreichend groß sein.

Eine Transformation an Ort und Stelle ist zulässig, wenn result == first1 oder bei der binären Form result == first2 gilt. Die Operation selbst darf weder Elemente der verarbeiteten Bereiche verändern noch Iteratoren ungültig machen. Verlasse dich nicht auf die Reihenfolge ihrer Aufrufe; am einfachsten ist es, ein Ergebnis ohne Seiteneffekte zurückzugeben.

Das Beispiel zeigt beide Formen ohne Ausführungsrichtlinie. Dieser Eintrag bezieht sich auf C++23; der angegebene Standardentwurf ist ein fortlaufend bearbeitetes Dokument und enthält auch spätere Erweiterungen, die im Beispiel nicht verwendet werden.

Beispiele

#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';
}

Ergebnis

1 4 9
2 6 12

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.

Quellen