std:: remove_copy, std:: remove_copy_if

将范围 [ first , last ) 中的元素复制到始于 d_first 的另一范围，同时省略满足特定条件的元素。

如果 * d_first = * first 无效 (C++20 前) * first 不可写入 d_first (C++20 起) ，则程序非良构。

如果源范围和目标范围重叠，则行为未定义。

参数

返回值

指向最后一个被复制元素之后位置的迭代器。

复杂度

给定 \(\scriptsize N\) N 为 std:: distance ( first, last ) ：

对于带有 ExecutionPolicy 的重载，如果 ForwardIt1 的 value_type 不满足 可移动构造 要求，则可能会产生性能开销。

异常

带有名为 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 << "处理前: " << std::quoted(str) << '\n';
    std::cout << "处理后:  \"";
    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
}

处理前: "#Return #Value #Optimization"
处理后:  "Return Value Optimization"
(2,2)(4,8)

缺陷报告

下列行为变更缺陷报告被追溯应用于先前发布的C++标准。

参见