std:: move_backward

範囲 [ first , last ) の要素を、 d_last で終わる別の範囲に移動します。要素は逆順で移動されます（最後の要素が最初に移動されます）が、相対的な順序は保持されます。

d_last が ( first , last ] の範囲内にある場合、動作は未定義です。この場合、 std::move を代わりに使用できます。

パラメータ

戻り値

宛先範囲のイテレータで、移動された最後の要素を指します。

計算量

正確に 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

関連項目