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("无重叠的情况；move_backward 之前：", src, dst);
    std::move_backward(src.begin(), src.end(), dst.end());
    print("之后：", src, dst);
 
    src = {"snap", "crackle", "pop", "lock", "drop"};
    print("有重叠的情况；move_backward 之前：", src);
    std::move_backward(src.begin(), std::next(src.begin(), 3), src.end());
    print("之后：", src);
}

输出：

无重叠的情况；move_backward 之前：
src: foo bar baz
dst: qux quux quuz corge
之后：
src: ∙ ∙ ∙
dst: qux foo bar baz
有重叠的情况；move_backward 之前：
src: snap crackle pop lock drop
之后：
src: ∙ ∙ snap crackle pop

参阅

move (C++11)	将某一范围的元素移动到一个新的位置 (函数模板)
ranges::move_backword (C++20)	按从后往前的顺序移动某一范围的元素到新的位置 (niebloid)

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

std::move_backward

参数

返回值

复杂度

可能的实现

注解

示例

参阅

导航