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