Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::copy_if : copier de façon stable les éléments satisfaisant un prédicat

std::copy_if teste chaque élément, ne copie que ceux dont le prédicat est vrai et renvoie la fin de la partie écrite de la destination.

Version : C++23

Syntaxe

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> évalue pred(*i) pour chacun des N éléments de [first, last) et copie ceux dont le résultat est vrai. Leur ordre relatif est préservé. Si M valeurs sont écrites, elle renvoie l’itérateur avancé de M positions depuis result ; l’opérateur + n’est pas requis.

Le prédicat est invoqué exactement N fois. Il ne doit pas modifier l’élément source ni invalider les itérateurs. La destination doit pouvoir contenir le pire cas, toute la plage, sauf avec un itérateur d’insertion ; l’algorithme ne redimensionne pas lui-même un conteneur ordinaire.

La source [first, last) et la suite des N premières positions de destination potentielles commençant à result ne doivent pas se chevaucher, même si moins d’éléments sont retenus. Une exception du prédicat ou de l’affectation sous toute politique standard, y compris seq, appelle std::terminate. Une plage vide renvoie result.

Exemples

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

Résultat

2 4 2

std::copy_if → 2 4 2

Sources