std:: copy_backward

Copia los elementos del rango [ first , last ) a otro rango que termina en d_last . Los elementos se copian en orden inverso (el último elemento se copia primero), pero se preserva su orden relativo.

El comportamiento es indefinido si d_last está dentro del rango ( first , last ] . En ese caso, debe usarse std::copy en lugar de std::copy_backward .

Parámetros

Valor de retorno

Iterador al último elemento copiado.

Complejidad

Exactamente std:: distance ( first, last ) asignaciones.

Notas

Al copiar rangos superpuestos, std::copy es apropiado al copiar hacia la izquierda (el inicio del rango destino está fuera del rango fuente) mientras que std::copy_backward es apropiado al copiar hacia la derecha (el final del rango destino está fuera del rango fuente).

Implementación posible

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

Ejemplo

#include <algorithm>
#include <iostream>
#include <numeric>
#include <vector>
int main()
{
    std::vector<int> source(4);
    std::iota(source.begin(), source.end(), 1); // llena con 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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Véase también