std::move_backward
来自cppreference.com
在标头 <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(constauto&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
[编辑]参阅
(C++11) | 将范围中元素移到新位置 (函数模板) |
(C++20) | 从后往前将范围中元素移到新位置 (算法函数对象) |
