Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 void

std::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.

Źródła