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 (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) |
以逆序將一個範圍的元素移動到一個新位置 (演算法函式物件) |
