std::copy_backward

template< class BidirIt1, class BidirIt2 >
BidirIt2 copy_backward( BidirIt1 first, BidirIt1 last, BidirIt2 d_last );

Copie les éléments de la plage [first, last) vers une autre plage se terminant à d_last. Les éléments sont copiés dans l'ordre inverse (le dernier élément est copié en premier), mais leur ordre relatif est préservé.

Le comportement est indéfini si d_last se trouve dans (first, last]. std::copy doit être utilisé à la place de std::copy_backward dans ce cas.

Paramètres

Valeur de retour

Itérateur pointant vers le dernier élément copié.

Complexité

Exactement std::distance(first, last) affectations.

Notes

Lors de la copie de plages qui se chevauchent, std::copy est approprié lors de la copie vers la gauche (le début de la plage de destination est en dehors de la plage source) tandis que std::copy_backward est approprié lors de la copie vers la droite (la fin de la plage de destination est en dehors de la plage source).

Implémentation possible

template<class BidirIt1, class BidirIt2>
BidirIt2 copy_backward(BidirIt1 first, BidirIt1 last, BidirIt2 d_last)
{
    while (first != last)
        *(--d_last) = *(--last);
    return d_last;
}

Exemple

#include <algorithm>
#include <iostream>
#include <numeric>
#include <vector>

int main()
{
    std::vector<int> source(4);
    std::iota(source.begin(), source.end(), 1); // fills with 1, 2, 3, 4
    
    std::vector<int> destination(6);
    
    std::copy_backward(source.begin(), source.end(), destination.end());
    
    std::cout << "destination contains: ";
    for (auto i: destination)
        std::cout << i << ' ';
    std::cout << '\n';
}

destination contains: 0 0 1 2 3 4

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi