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

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

Fontes