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