std:: remove_copy, std:: remove_copy_if

範囲 [ first , last ) から、特定の条件を満たす要素を除外して、 d_first で始まる別の範囲へ要素をコピーします。

* d_first = * first が無効な場合 (C++20まで) * first が writable でなく d_first に書き込めない場合 (C++20以降) 、プログラムは不適格となる。

ソースとデスティネーションの範囲が重なる場合、動作は未定義です。

パラメータ

戻り値

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

計算量

与えられた \(\scriptsize N\) N を std:: distance ( first, last ) として：

ExecutionPolicyを取るオーバーロードでは、 ForwardIt1 の value_type が MoveConstructible でない場合、パフォーマンスコストが生じる可能性があります。

例外

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

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

実装例

template<class InputIt, class OutputIt,
         class T = typename std::iterator_traits<InputIt>::value_type>
constexpr OutputIt remove_copy(InputIt first, InputIt last,
                               OutputIt d_first, const T& value)
{
    for (; first != last; ++first)
        if (!(*first == value))
            *d_first++ = *first;
    return d_first;
}

template<class InputIt, class OutputIt, class UnaryPred>
constexpr OutputIt remove_copy_if(InputIt first, InputIt last,
                                  OutputIt d_first, UnaryPred p)
{
    for (; first != last; ++first)
        if (!p(*first))
            *d_first++ = *first;
    return d_first;
}

注記

例

#include <algorithm>
#include <complex>
#include <iomanip>
#include <iostream>
#include <iterator>
#include <string>
#include <vector>
int main()
{
    // ハッシュ文字 '#' をその場で削除
    std::string str = "#Return #Value #Optimization";
    std::cout << "before: " << std::quoted(str) << '\n';
    std::cout << "after:  \"";
    std::remove_copy(str.begin(), str.end(),
                     std::ostream_iterator<char>(std::cout), '#');
    std::cout << "\"\n";
    // {1, 3} の値をその場で削除
    std::vector<std::complex<double>> nums{{2, 2}, {1, 3}, {4, 8}, {1, 3}};
    std::remove_copy(nums.begin(), nums.end(),
                     std::ostream_iterator<std::complex<double>>(std::cout),
    #ifdef __cpp_lib_algorithm_default_value_type
                     {1, 3}); // T は推論される
    #else
                     std::complex<double>{1, 3});
    #endif
}

before: "#Return #Value #Optimization"
after:  "Return Value Optimization"
(2,2)(4,8)

不具合報告

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

関連項目