CKTIS / C++
std::replace_if — zamiana elementów spełniających warunek
std::replace_if z nagłówka <algorithm> zastępuje w miejscu elementy spełniające predykat jedną podaną wartością. Nie zmienia liczby elementów i zwraca void.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <algorithm>
std::replace_if(first, last, pred, new_value); // returns voidstd::replace_if(first, last, pred, new_value) działa na półotwartym zakresie [first, last): obejmuje first, ale nie last. Gdy pred(*i) jest prawdziwe, przypisuje new_value do danego elementu. Pozostałe elementy pozostają bez zmian; algorytm nie usuwa elementów ani nie zmienia rozmiaru kontenera.
Wymagane są modyfikowalne iteratory co najmniej kategorii forward oraz możliwość przypisania new_value przez iterator. Predykat ma zwracać wynik interpretowalny logicznie i nie może modyfikować badanego elementu. Dla zakresu o długości N wykonywanych jest dokładnie N wywołań predykatu, więc złożoność jest liniowa. Wynikiem jest void, nie liczba zamian.
Przykład zastępuje liczby ujemne przez 0. W odróżnieniu od std::replace, warunek określa predykat, a nie porównanie z jedną starą wartością. Jeśli potrzebujesz osobnego zakresu wynikowego, rozważ std::replace_copy_if. Jeśli new_value jest referencją do elementu zakresu, który spełnia predykat, algorytm przypisze ten element do niego samego. Dla typu int, użytego w przykładzie, takie przypisanie nie zmienia wartości. Aby nie polegać na tym, jak typ elementu obsługuje przypisanie do samego siebie, przekaż osobną kopię wartości zastępującej.
Pokazano przeciążenie bez polityki wykonania, odpowiednie dla C++23. Podane źródła są aktualizowanym szkicem standardu i mogą zawierać późniejsze rozszerzenia.
Przykłady
#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';
}
Wynik
4 0 0 0 9
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.