std::move_backward
ja.cppreference.net より
| ヘッダ <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
関連項目
(C++11) |
要素の範囲を新しい位置に移動します (関数テンプレート & アルゴリズム関数オブジェクト) |
(C++20) |
|
(C++20) |
要素の範囲を逆順で新しい位置に移動します (アルゴリズム関数オブジェクト) |