std::move_backward

Определено в заголовке <algorithm>

Определено в заголовке `<algorithm>`
template< class BidirIt1, class BidirIt2 > BidirIt2 move_backward( BidirIt1 first, BidirIt1 last, BidirIt2 d_last );		(с C++11) (до C++20)
template< class BidirIt1, class BidirIt2 > constexpr BidirIt2 move_backward( BidirIt1 first, BidirIt1 last, BidirIt2 d_last );		(с C++20)

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

(с C++11)
(до C++20)

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

(с C++20)

Перемещает элементы из диапазона [first, last), в другой диапазон, заканчивающийся в d_last. Элементы перемещаются в обратном порядке (сначала последний элемент), но их относительный порядок сохраняется.

Поведение является неопределённым, если d_last находится в пределах [first, last]. В этом случае необходимо использовать std::move, а не std::move_backward.

Параметры

first, last	-	диапазон перемещаемых элементов
d_last	-	конец целевого диапазона
Требования к типу
-`BidirIt1, BidirIt2` должно удовлетворять требованиям LegacyBidirectionalIterator.

Возвращаемое значение

Итератор в целевом диапазоне, указывающий на последний перемещённый элемент.

Сложность

Ровно last - first присваиваний перемещения.

Возможная реализация

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;
}

Примечания

При перемещении перекрывающихся диапазонов, std::move подходит для перемещения влево (начало целевого диапазона находится вне исходного диапазона), в то время как std::move_backward подходит для перемещения вправо (конец целевого диапазона находится вне исходного диапазона).

Пример

#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("Non-overlapping case; before move_backward:", src, dst);
    std::move_backward(src.begin(), src.end(), dst.end());
    print("After:", src, dst);
 
    src = {"snap", "crackle", "pop", "lock", "drop"};
    print("Overlapping case; before move_backward:", src);
    std::move_backward(src.begin(), std::next(src.begin(), 3), src.end());
    print("After:", src);
}

Вывод:

Non-overlapping case; before move_backward:
src: foo bar baz
dst: qux quux quuz corge
After:
src: ∙ ∙ ∙
dst: qux foo bar baz
Overlapping case; before move_backward:
src: snap crackle pop lock drop
After:
src: ∙ ∙ snap crackle pop

См. также

move (C++11)	перемещает диапазон элементов в новое местоположение (шаблон функции)
ranges::move_backward (C++20)	перемещает диапазон элементов в новое местоположение в обратном порядке (niebloid)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/algorithm/move_backward