命名空间
变体
操作

std::replace_copy, std::replace_copy_if

来自 cppreference.cn
< cpp‎ | algorithm
 
C++
 
算法库
约束算法和范围上的算法 (C++20)
约束算法，例如 ranges::copy, ranges::sort, ...
执行策略 (C++17)
排序和相关操作
划分操作
排序操作
二分搜索操作
(在已划分范围上)
集合操作 (在已排序范围上)
合并操作 (在已排序范围上)
堆操作
最小值/最大值操作
(C++11)
(C++17)
字典序比较操作
(C++20)
排列操作
C 库
数值操作
未初始化内存上的操作
 
定义于头文件 <algorithm>
template< class InputIt, class OutputIt, class T >

OutputIt replace_copy( InputIt first, InputIt last, OutputIt d_first,

                       const T& old_value, const T& new_value );
 (1) (constexpr since C++20)
template< class ExecutionPolicy,

          class ForwardIt1, class ForwardIt2, class T >
ForwardIt2 replace_copy
    ( ExecutionPolicy&& policy,
      ForwardIt1 first, ForwardIt1 last, ForwardIt2 d_first,

      const T& old_value, const T& new_value );
 (2) (since C++17)
(3)
template< class InputIt, class OutputIt, class UnaryPred, class T >

OutputIt replace_copy_if
    ( InputIt first, InputIt last, OutputIt d_first,

      UnaryPred p, const T& new_value );
 (constexpr since C++20)
(until C++26)
template< class InputIt, class OutputIt, class UnaryPred,

          class T = typename std::iterator_traits
                        <OutputIt>::value_type >
constexpr OutputIt replace_copy_if
    ( InputIt first, InputIt last, OutputIt d_first,

      UnaryPred p, const T& new_value );
 (since C++26)
(4)
template< class ExecutionPolicy, class ForwardIt1, class ForwardIt2,

          class UnaryPred, class T >
ForwardIt2 replace_copy_if
    ( ExecutionPolicy&& policy,
      ForwardIt1 first, ForwardIt1 last, ForwardIt2 d_first,

      UnaryPred p, const T& new_value );
 (since C++17)
(until C++26)
template< class ExecutionPolicy, class ForwardIt1, class ForwardIt2,

          class UnaryPred, class T = typename std::iterator_traits
                                         <ForwardIt2>::value_type >
ForwardIt2 replace_copy_if
    ( ExecutionPolicy&& policy,
      ForwardIt1 first, ForwardIt1 last, ForwardIt2 d_first,

      UnaryPred p, const T& new_value );
 (since C++26)

将范围 [first, last) 中的元素复制到以 d_first 开头的另一个范围，同时将所有满足特定条件的元素替换为 new_value。

1) 替换所有等于 old_value 的元素（使用 operator==）。
3) 替换所有谓词 p 返回 true 的元素。
2,4) 与 (1,3) 相同，但根据 policy 执行。
这些重载仅在满足以下所有条件时才参与重载解析

std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> 为 true。

 (until C++20)

std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>> 为 true。

 (since C++20)

如果表达式 *first 和 new_value 的任何结果都不可 写入 到 d_first，则程序是非良构的。

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

目录

[编辑] 参数

first, last - 定义要复制的元素的源 范围 的迭代器对
d_first - 目标范围的起始
old_value - 要替换的元素的值
policy - 要使用的执行策略
p - 一元谓词，如果元素值应被替换，则返回 ​true。

对于类型为 VT（可能是 const）的每个参数 v，表达式 p(v) 必须可转换为 bool，其中 VT 是 InputIt 的值类型，无论 值类别 如何，并且不得修改 v。 因此，不允许使用参数类型 VT&，也不允许使用 VT，除非对于 VT，移动等同于复制(自 C++11 起)。 ​

new_value - 用作替换的值
类型要求
-
InputIt 必须满足 LegacyInputIterator 的要求。
-
OutputIt 必须满足 LegacyOutputIterator 的要求。
-
ForwardIt1, ForwardIt2 必须满足 LegacyForwardIterator 的要求。

[编辑] 返回值

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

[编辑] 复杂度

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

1,2) 精确地 N 次使用 operator== 的比较。
3,4) 精确地 N 次谓词 p 的应用。

[编辑] 异常

具有名为 ExecutionPolicy 的模板参数的重载按如下方式报告错误

  • 如果作为算法一部分调用的函数的执行抛出异常，并且 ExecutionPolicy 是 标准策略 之一，则调用 std::terminate。 对于任何其他 ExecutionPolicy，行为是实现定义的。
  • 如果算法无法分配内存，则抛出 std::bad_alloc。

[编辑] 可能的实现

replace_copy (1) 
template<class InputIt, class OutputIt, class T>
OutputIt replace_copy(InputIt first, InputIt last, OutputIt d_first,
                      const T& old_value, const T& new_value)
{
    for (; first != last; ++first)
        *d_first++ = (*first == old_value) ? new_value : *first;
    return d_first;
}
replace_copy_if (3) 
template<class InputIt, class OutputIt, class UnaryPred,
         class T = typename std::iterator_traits<ForwardIt>::value_type>
OutputIt replace_copy_if(InputIt first, InputIt last, OutputIt d_first,
                         UnaryPred p, const T& new_value)
{
    for (; first != last; ++first)
        *d_first++ = p(*first) ? new_value : *first;
    return d_first;
}

[编辑] 注意

特性测试 宏 值 Std 特性
__cpp_lib_algorithm_default_value_type 202403 (C++26) 列表初始化 用于算法 (3,4)

[编辑] 示例

运行此代码
#include <algorithm>
#include <complex>
#include <iostream>
#include <vector>
 
void println(const auto& seq)
{
    for (const auto& e : seq)
        std::cout << e << ' ';
    std::cout << '\n';
}
 
int main()
{
    std::vector<short> src{3, 1, 4, 1, 5, 9, 2, 6, 5};
    println(src);
    std::vector<int> dst(src.size());
    std::replace_copy_if(src.cbegin(), src.cend(),
                         dst.begin(),
                         [](short n){ return n > 5; }, 0);
    println(dst);
 
    std::vector<std::complex<double>> src2{{1, 3}, {2, 4}, {3, 5}},
                                      dst2(src2.size());
    println(src2);
    #ifdef __cpp_lib_algorithm_default_value_type
        std::replace_copy_if(src2.cbegin(), src2.cend(), dst2.begin(),
            [](std::complex<double> z){ return std::abs(z) < 5; },
            {4, 2}); // Possible, since the T is deduced.
    #else
        std::replace_copy_if(src2.cbegin(), src2.cend(), dst2.begin(),
            [](std::complex<double> z){ return std::abs(z) < 5; },
            std::complex<double>{4, 2});
    #endif
    println(dst2);
}

输出

3 1 4 1 5 9 2 6 5 
3 1 4 1 5 0 2 0 5 
(1,3) (2,4) (3,5) 
(4,2) (4,2) (3,5)

[编辑] 缺陷报告

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

DR 应用于 已发布行为 正确行为
LWG 283 C++98 T 需要是 CopyAssignable（和 EqualityComparable 用于
replace_copy），但 InputIt 的值类型并不总是 T		 移除了要求
LWG 337 C++98 replace_copy_if 仅要求 InputIt
满足 LegacyIterator[1] 的要求		 更正为
LegacyInputIterator
  1. ↑ C++ 标准中的实际缺陷是将模板参数 InputIterator 错误地指定为 Iterator。 这会影响类型要求，因为 C++ 标准声明，对于算法库中的函数模板，名称以 Iterator 结尾的模板类型参数暗示了相应迭代器类别的类型要求。

[编辑] 参见

 将所有满足特定条件的值替换为另一个值
(函数模板) [编辑]
 移除满足特定条件的元素
(函数模板) [编辑]
(C++20)(C++20)
 复制一个范围，将满足特定条件的元素替换为另一个值
(算法函数对象)[编辑]
Retrieved from "https://cppreference.cn/mwiki/index.php?title=cpp/algorithm/replace_copy&oldid=180622"