Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::copy_if: copiare stabilmente gli elementi che soddisfano un predicato

std::copy_if verifica ogni elemento, copia solo quelli con predicato vero e restituisce la fine della parte scritta della destinazione.

Versione: C++23

Sintassi

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) di <algorithm> valuta pred(*i) per ciascuno degli N elementi in [first, last) e copia quelli per cui il risultato è vero. Mantiene il loro ordine relativo. Se scrive M valori, restituisce l’iteratore avanzato di M posizioni da result; non richiede l’operatore +.

Il predicato è invocato esattamente N volte. Non deve modificare l’elemento sorgente né invalidare iteratori. La destinazione deve avere spazio per il caso peggiore, l’intero intervallo, salvo l’uso di un iteratore di inserimento; l’algoritmo non ridimensiona da solo un contenitore ordinario.

La sorgente [first, last) e la sequenza delle prime N posizioni potenziali di destinazione a partire da result non possono sovrapporsi, anche se sono scelti meno elementi. Un’eccezione del predicato o assegnamento con qualsiasi policy standard, inclusa seq, chiama std::terminate. Un intervallo vuoto restituisce result.

Esempi

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

Risultato

2 4 2

std::copy_if → 2 4 2

Fonti