std::move_backward

定义在头文件 `<algorithm>` 中
template< class BidirIt1, class BidirIt2 > BidirIt2 move_backward( BidirIt1 first, BidirIt1 last, BidirIt2 d_last );		(自 C++11 起) (自 C++20 起为 constexpr)

将范围 [first, last) 中的元素移动到以 d_last 结尾的另一个范围。元素按反向顺序移动（最后一个元素首先移动），但它们之间的相对顺序保持不变。

如果 d_last 在 (first, last] 中，则行为未定义。在这种情况下，可以使用 std::move。

[编辑] 参数

first, last	-	要移动的元素范围
d_last	-	目标范围的结尾
类型要求
- `BidirIt1, BidirIt2` 必须满足 LegacyBidirectionalIterator 的要求。

[编辑] 返回值

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

[编辑] 复杂度

正好 std::distance(first, last) 次移动赋值。

[编辑] 可能的实现

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)[编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作