Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::replace_if — substituir elementos que satisfazem uma condição

std::replace_if de <algorithm> substitui no próprio intervalo os elementos que satisfazem um predicado por um valor fornecido. Mantém o número de elementos e devolve void.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <algorithm>

std::replace_if(first, last, pred, new_value); // returns void

std::replace_if(first, last, pred, new_value) opera sobre o intervalo semiaberto [first, last): inclui first, mas exclui last. Quando pred(*i) é verdadeiro, atribui new_value ao elemento correspondente. Os restantes elementos mantêm-se inalterados; o algoritmo não remove elementos nem altera o tamanho do contentor.

São necessários iteradores modificáveis de, pelo menos, categoria forward e a possibilidade de atribuir new_value através de um iterador. O predicado tem de produzir um resultado interpretável como booleano e não pode modificar o elemento testado. Para um intervalo de comprimento N, o predicado é chamado exatamente N vezes, pelo que a complexidade é linear. O resultado é void, não o número de substituições.

O exemplo substitui os números negativos por 0. Ao contrário de std::replace, a condição é determinada por um predicado, em vez de uma comparação com um único valor antigo. Se precisar de um intervalo de saída separado, considere std::replace_copy_if. Se new_value referenciar um elemento do intervalo que satisfaz o predicado, o algoritmo atribui esse elemento a si próprio. Para o tipo int usado no exemplo, a autoatribuição não altera o valor. Para não depender da forma como o tipo do elemento trata a autoatribuição, passe uma cópia separada do valor de substituição.

A sobrecarga apresentada não tem política de execução e é adequada para C++23. As fontes fornecidas são um rascunho do standard atualizado continuamente e podem conter extensões posteriores.

Exemplos

#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';
}

Resultado

4 0 0 0 9

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes