CKTIS / C++
std::replace_if — nahrazení prvků splňujících podmínku
std::replace_if z <algorithm> nahrazuje přímo v rozsahu prvky, které splňují predikát, zadanou hodnotou. Počet prvků nemění a vrací void.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <algorithm>
std::replace_if(first, last, pred, new_value); // returns voidstd::replace_if(first, last, pred, new_value) pracuje s polouzavřeným rozsahem [first, last): first zahrnuje, last nikoli. Pokud je pred(*i) pravdivé, přiřadí příslušnému prvku hodnotu new_value. Ostatní prvky zůstanou beze změny; algoritmus žádné prvky nemaže ani nemění velikost kontejneru.
Jsou potřeba modifikovatelné iterátory alespoň kategorie forward a možnost přiřadit new_value prostřednictvím iterátoru. Predikát musí vracet výsledek interpretovatelný jako logická hodnota a nesmí měnit testovaný prvek. Pro rozsah délky N se predikát zavolá přesně Nkrát, takže složitost je lineární. Výsledkem je void, nikoli počet nahrazených prvků.
Příklad nahrazuje záporná čísla hodnotou 0. Na rozdíl od std::replace určuje podmínku predikát, nikoli porovnání s jednou původní hodnotou. Pokud potřebujete samostatný výstupní rozsah, zvažte std::replace_copy_if. Pokud new_value odkazuje na prvek v rozsahu, který splňuje predikát, algoritmus tento prvek přiřadí sám sobě. U typu int použitého v příkladu takové přiřazení hodnotu nezmění. Abyste nemuseli spoléhat na to, jak typ prvku zpracovává přiřazení sobě samému, předejte samostatnou kopii náhradní hodnoty.
Zobrazené přetížení nepoužívá zásadu provádění a je vhodné pro C++23. Uvedené zdroje jsou průběžně aktualizovaný návrh standardu a mohou obsahovat pozdější rozšíření.
Příklady
#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';
}
Výsledek
4 0 0 0 9
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.