Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::copy_if: copiar establemente elementos que cumplen un predicado

std::copy_if prueba cada elemento, copia solo los que dan predicado verdadero y devuelve el final de la parte escrita del destino.

Versión: C++23

Sintaxis

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>, evalúa pred(*i) para cada uno de los N elementos de [first, last) y copia aquellos cuyo resultado es verdadero. Conserva su orden relativo. Si escribe M valores, devuelve el iterador avanzado M posiciones desde result; no exige el operador +.

El predicado se invoca exactamente N veces. No debe modificar el elemento origen ni invalidar iteradores. El destino necesita espacio para el peor caso, todo el rango, salvo con un iterador de inserción; el algoritmo no redimensiona por sí mismo un contenedor normal.

El origen [first, last) y la secuencia de las primeras N posiciones potenciales del destino que comienza en result no pueden solaparse, aunque se elijan menos elementos. Una excepción del predicado o asignación bajo cualquier política estándar, incluida seq, llama a std::terminate. Un rango vacío devuelve result.

Ejemplos

#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

Fuentes