CKTIS / C++
std::replace_if — Elemente ersetzen, die eine Bedingung erfüllen
std::replace_if aus <algorithm> ersetzt Elemente, die ein Prädikat erfüllen, direkt durch einen angegebenen Wert. Die Anzahl der Elemente bleibt unverändert; die Funktion gibt void zurück.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <algorithm>
std::replace_if(first, last, pred, new_value); // returns voidstd::replace_if(first, last, pred, new_value) arbeitet auf dem halboffenen Bereich [first, last): first ist enthalten, last nicht. Wenn pred(*i) wahr ist, weist der Algorithmus dem jeweiligen Element new_value zu. Alle anderen Elemente bleiben unverändert; der Algorithmus entfernt keine Elemente und ändert nicht die Größe des Containers.
Erforderlich sind veränderbare Iteratoren mindestens der Kategorie Forward sowie die Möglichkeit, new_value über einen Iterator zuzuweisen. Das Prädikat muss ein logisch auswertbares Ergebnis liefern und darf das geprüfte Element nicht verändern. Bei einem Bereich der Länge N wird das Prädikat genau N-mal aufgerufen; die Komplexität ist daher linear. Das Ergebnis ist void, nicht die Anzahl der Ersetzungen.
Das Beispiel ersetzt negative Zahlen durch 0. Anders als bei std::replace wird die Bedingung durch ein Prädikat festgelegt und nicht durch den Vergleich mit einem einzelnen alten Wert. Wenn ein separater Ausgabebereich benötigt wird, kommt std::replace_copy_if infrage. Verweist new_value auf ein Element im Bereich, das das Prädikat erfüllt, weist der Algorithmus dieses Element sich selbst zu. Beim Typ int, der im Beispiel verwendet wird, bleibt der Wert bei einer Selbstzuweisung unverändert. Übergib eine separate Kopie des Ersatzwerts, wenn du nicht davon abhängen möchtest, wie der Elementtyp Selbstzuweisungen behandelt.
Gezeigt wird die Überladung ohne Ausführungsrichtlinie, die für C++23 geeignet ist. Die angegebenen Quellen sind ein fortlaufend aktualisierter Standardentwurf und können spätere Erweiterungen enthalten.
Beispiele
#include <algorithm>
#include <array>
#include <cstddef>
#include <iostream>
int main() {
std::array<int, 5> values{4, -2, 0, -7, 9};
std::replace_if(values.begin(), values.end(),
[](int x) { return x < 0; }, 0);
for (std::size_t i = 0; i < values.size(); ++i) {
if (i != 0) std::cout << ' ';
std::cout << values[i];
}
std::cout << '\n';
}
Ergebnis
4 0 0 0 9
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.