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

CKTIS / C++

std::copy : copier une plage dans un stockage existant

std::copy affecte chaque élément d’une plage d’entrée à des positions consécutives de destination et renvoie l’itérateur suivant la dernière écriture.

Version : C++23

Syntaxe

template<class InputIterator, class OutputIterator>
constexpr OutputIterator copy(InputIterator first, InputIterator last,
                              OutputIterator result);

std::copy(first, last, result) de <algorithm> avance dans l’ordre et effectue exactement N affectations *out = *in, où N est le nombre d’éléments de [first, last). Elle renvoie l’itérateur avancé de N positions depuis result ; cette description du résultat n’exige pas l’opérateur +. L’ordre est conservé. Une copie ordinaire entre objets disjoints ne modifie pas la source, mais un décalage chevauchant vers la gauche peut écraser une partie du tampon commun, et un std::move_iterator peut déplacer depuis la source.

La destination doit contenir les N éléments ; std::copy n’agrandit pas un conteneur sauf avec un itérateur d’insertion. Pour la surcharge ordinaire, result ne doit pas appartenir à [first, last). Pour décaler vers la droite dans le même tampon, utilise std::copy_backward.

La surcharge avec execution policy exige des plages source et destination entièrement disjointes. Une exception d’affectation sous toute politique standard, y compris seq, appelle std::terminate. Une plage vide n’effectue aucune affectation et renvoie result inchangé.

Exemples

#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>

int main() {
    const std::vector<int> source{1, 2, 3};
    std::vector<int> destination(5, -1);
    const auto end = std::copy(source.begin(), source.end(), destination.begin() + 1);
    std::cout << std::distance(destination.begin(), end) << ' ';
    for (std::size_t i = 0; i < destination.size(); ++i) {
        if (i != 0) std::cout << ',';
        std::cout << destination[i];
    }
    std::cout << '\n';
}

Résultat

4 -1,1,2,3,-1

std::copy → 4 -1,1,2,3,-1

Sources