std::move_backward - cppreference.com

De cppreference.com

Definido en el archivo de encabezado `<algorithm>`
`template< class BidirIt1, class BidirIt2 > BidirIt2 move_backward( BidirIt1 first, BidirIt1 last, BidirIt2 d_last );`		(desde C++11) (hasta C++20)
`template< class BidirIt1, class BidirIt2 > constexpr BidirIt2 move_backward( BidirIt1 first, BidirIt1 last, BidirIt2 d_last );`		(desde C++20)

Mueve los elementos del rango [first, last) a otro rango que termina en d_last. Los elementos se mueven en orden inverso (el último elemento se mueve primero), pero se conserva su orden relativo.

El comportamiento no está definido si d_last está dentro de [first, last). std::move debe usarse en lugar de std::move_backward en ese caso.

Parámetros

first, last	-	El rango de los elementos a mover.
d_last	-	El final del rango de destino.
Requisitos de tipo
-`BidirIt1, BidirIt2` debe satisfacer los requisitos de BidirectionalIterator.

Valor de retorno

Un iterador en el rango de destino, apuntando al último elemento movido.

Complejidad

Exactamente last - first asignaciones por movimiento.

Posible implementación

template<class BidirIt1, class BidirIt2>
BidirIt2 move_backward(BidirIt1 first, BidirIt1 last,
                       BidirIt2 d_last)
{
    while (first != last)
        *(--d_last) = std::move(*(--last));

    return d_last;
}

Notas

Al mover rangos superpuestos, std::move es apropiado cuando se mueve hacia la izquierda (el comienzo del rango de destino está fuera del rango de origen) mientras que std::move_backward es apropiado cuando se mueve hacia la derecha (el final del rango de destino está fuera del rango de origen).

Ejemplo

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

using container = std::vector<std::string>;

void print(std::string_view comment, const container& src, const container& dst = {})
{
    auto prn = [](std::string_view name, const container& cont)
    {
        std::cout << name;
        for (const auto &s : cont) { std::cout << (s.empty() ? "∙" : s.data()) << ' '; }
        std::cout << '\n';
    };
    std::cout << comment << '\n';
    prn("src: ", src);
    if (dst.empty()) return;
    prn("dst: ", dst);
}

int main()
{
    container src {"foo", "bar", "baz"};
    container dst {"qux", "quux", "quuz", "corge"};
    print("Caso no superpuesto; antes de move_backward:", src, dst);
    std::move_backward(src.begin(), src.end(), dst.end());
    print("Después:", src, dst);

    src = {"snap", "crackle", "pop", "lock", "drop"};
    print("Caso superpuesto; antes de move_backward:", src);
    std::move_backward(src.begin(), std::next(src.begin(), 3), src.end());
    print("Después:", src);
}

Salida:

Caso no superpuesto; antes de move_backward:
src: foo bar baz
dst: qux quux quuz corge
Después:
src: ∙ ∙ ∙
dst: qux foo bar baz
Caso superpuesto; antes de move_backward:
src: snap crackle pop lock drop
Después:
src: ∙ ∙ snap crackle pop

Véase también

	Mueve una serie de elementos a una nueva ubicación. (plantilla de función) [editar]
	Mueve un rango de elementos a una nueva ubicación en orden inverso. (niebloid) [editar]