std::move_backward() 算法

自 C++20 起

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

自 C++11 起

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

• (1) 将元素从范围 [first; last) 移动到另一个以 d_last 结尾的范围。

  元素以逆序移动（最后一个元素先移动），但其相对顺序保持不变。

  未定义行为

  如果 d_first 在 [first; last) 范围内，则行为未定义。在这种情况下，可以改用std::move。

参数

first last	要移动的元素范围。
d_first	目标范围的开头。

类型要求

BidirIt1 BidirIt2

LegacyBidirectionalIterator

返回值

目标范围中的迭代器，指向最后一个被移动的元素。

复杂度

恰好 last - first 次赋值。

异常

(无)

可能的实现

move_backward (1)

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 适用于向右移动时（目标范围的结束点在源范围之外）。

示例

Main.cpp

#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