Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 void

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

Zdroje