CKTIS / C++
std::replace_if — elementen vervangen die aan een voorwaarde voldoen
std::replace_if uit <algorithm> vervangt elementen die aan een predicaat voldoen ter plekke door één opgegeven waarde. Het aantal elementen blijft gelijk en de functie retourneert void.
Versie: 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) werkt op het halfopen bereik [first, last): first is inbegrepen en last niet. Als pred(*i) waar is, wijst het algoritme new_value toe aan het betreffende element. De andere elementen blijven ongewijzigd; het algoritme verwijdert geen elementen en verandert de grootte van de container niet.
Er zijn wijzigbare iterators van minstens de forward-categorie nodig, en new_value moet via een iterator kunnen worden toegewezen. Het predicaat moet een resultaat opleveren dat als een booleaanse waarde kan worden getest en mag het geteste element niet wijzigen. Voor een bereik met lengte N wordt het predicaat precies N keer aangeroepen; de complexiteit is dus lineair. Het resultaat is void, niet het aantal vervangingen.
Het voorbeeld vervangt negatieve getallen door 0. Anders dan bij std::replace wordt de voorwaarde bepaald door een predicaat, niet door vergelijking met één oude waarde. Heb je een afzonderlijk uitvoerbereik nodig, overweeg dan std::replace_copy_if. Als new_value verwijst naar een element in het bereik dat aan het predicaat voldoet, wijst het algoritme dat element aan zichzelf toe. Bij het type int uit het voorbeeld verandert de waarde daardoor niet. Geef een aparte kopie van de vervangingswaarde door als je niet wilt afhangen van hoe het elementtype omgaat met toewijzing aan zichzelf.
De getoonde overload heeft geen uitvoeringsbeleid en is geschikt voor C++23. De opgegeven bronnen zijn een voortdurend bijgewerkt concept van de standaard en kunnen latere uitbreidingen bevatten.
Voorbeelden
#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';
}
Resultaat
4 0 0 0 9
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.