CKTIS / C++
std::copy_if: copiar estavelmente elementos que satisfazem um predicado
std::copy_if testa cada elemento, copia apenas os que dão predicado verdadeiro e devolve o fim da parte escrita do destino.
Versão: C++23
Sintaxe
template<class InputIterator, class OutputIterator, class Predicate>
constexpr OutputIterator copy_if(InputIterator first, InputIterator last,
OutputIterator result, Predicate pred);std::copy_if(first, last, result, pred), de <algorithm>, avalia pred(*i) para cada um dos N elementos em [first, last) e copia aqueles cujo resultado é verdadeiro. Preserva a ordem relativa. Se escrever M valores, devolve o iterador avançado M posições a partir de result; não exige o operador +.
O predicado é invocado exatamente N vezes. Não deve alterar o elemento de origem nem invalidar iteradores. O destino precisa de espaço para o pior caso, todo o intervalo, exceto com um iterador de inserção; o algoritmo não redimensiona sozinho um contentor normal.
A origem [first, last) e a sequência das primeiras N posições potenciais de destino que começa em result não podem sobrepor-se, mesmo que sejam escolhidos menos elementos. Uma exceção do predicado ou atribuição sob qualquer política padrão, incluindo seq, chama std::terminate. Um intervalo vazio devolve result.
Exemplos
#include <algorithm>
#include <array>
#include <iostream>
#include <iterator>
#include <vector>
int main() {
const std::vector<int> source{1, 4, 2, 5};
std::array<int, 4> destination{};
const auto end = std::copy_if(source.begin(), source.end(), destination.begin(),
[](int value) { return value % 2 == 0; });
const auto written = std::distance(destination.begin(), end);
std::cout << written;
for (auto it = destination.begin(); it != end; ++it) std::cout << ' ' << *it;
std::cout << '\n';
}
Resultado
2 4 2
std::copy_if → 2 4 2