std::move_backward
| 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.
Contenido |
[editar] 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.
| ||
[editar] Valor de retorno
Un iterador en el rango de destino, apuntando al último elemento movido.
[editar] Complejidad
Exactamente last - first asignaciones por movimiento.
[editar] 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; } |
[editar] 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).
[editar] 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
[editar] Véase también
| (C++11) |
Mueve una serie de elementos a una nueva ubicación. (plantilla de función) |
| (C++20) |
Mueve un rango de elementos a una nueva ubicación en orden inverso. (niebloid) |
