std::move_backward

定义于头文件 `<algorithm>`
template< class BidirIt1, class BidirIt2 > BidirIt2 move_backward( BidirIt1 first, BidirIt1 last, BidirIt2 d_last );		(始于 C++11) (constexpr 始于 C++20)

将范围 [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)	以逆序将某个范围的元素移动到新位置 (算法函数对象)[编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
具名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

cppreference.cn

命名空间

变体

视图

操作