std:: reverse_copy

パラメータ

戻り値

コピーされた最後の要素の次の要素を指す出力イテレータ。

計算量

正確に \(\scriptsize N\) N 個のアサインメント。

例外

ExecutionPolicy という名前のテンプレートパラメータを持つオーバーロードは、 以下のようにエラーを報告します：

• アルゴリズムの一部として呼び出された関数の実行が例外をスローした場合、 ExecutionPolicy が 標準ポリシー のいずれかであるとき、 std::terminate が呼び出される。その他の ExecutionPolicy については、動作は実装定義である。
• アルゴリズムがメモリの確保に失敗した場合、 std::bad_alloc がスローされる。

実装例

実装例については libstdc++ 、 libc++ 、および MSVC STL も参照してください。

template<class BidirIt, class OutputIt>
constexpr // C++20以降
OutputIt reverse_copy(BidirIt first, BidirIt last, OutputIt d_first)
{
    for (; first != last; ++d_first)
        *d_first = *(--last);
    return d_first;
}

注記

実装（例： MSVC STL ）は、両方のイテレータ型が LegacyContiguousIterator を満たし、同じ値型を持ち、かつ値型が TriviallyCopyable である場合にベクトル化を有効化することがあります。

例

#include <algorithm>
#include <iostream>
#include <vector>
int main()
{
    auto print = [](const std::vector<int>& v)
    {
        for (const auto& value : v)
            std::cout << value << ' ';
        std::cout << '\n';
    };
    std::vector<int> v{1, 2, 3};
    print(v);
    std::vector<int> destination(3);
    std::reverse_copy(std::begin(v), std::end(v), std::begin(destination));
    print(destination);
    std::reverse_copy(std::rbegin(v), std::rend(v), std::begin(destination));
    print(destination);
}

1 2 3 
3 2 1 
1 2 3

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

1. ↑ ^{1.0 1.1 1.2} LegacyOutputIterator は二項演算子 + および - をサポートする必要はありません。ここでの + および - の使用は説明専用です：実際の計算ではこれらを使用する必要はありません。

関連項目