std::replace_if

template <class ForwardIterator, class UnaryPredicate, class T>  void replace_if (ForwardIterator first, ForwardIterator last,                   UnaryPredicate pred, const T& new_value );

在范围内替换值

对于使得 pred 返回 true 的范围 [first,last) 中的所有元素，将 new_value 赋给它们。

此函数模板的行为等同于

template < class ForwardIterator, class UnaryPredicate, class T >
  void replace_if (ForwardIterator first, ForwardIterator last,
                   UnaryPredicate pred, const T& new_value)
{
  while (first!=last) {
    if (pred(*first)) *first=new_value;
    ++first;
  }
}

参数

first, last: Forward iterators 指向支持被赋值为 T 类型值的元素序列的初始和末尾位置。使用的范围是 [first,last)，它包含 first 和 last 之间的所有元素，包括 first 指向的元素，但不包括 last 指向的元素。
pred: 一元函数，接受范围内的元素作为参数，并返回一个可转换为 bool 的值。返回的值指示元素是否应该被替换（如果为 true，则会被替换）。
该函数不得修改其参数。
这可以是函数指针或函数对象。
new_value: 要赋给被替换元素的值。

返回值

无

示例

// replace_if example
#include <iostream>     // std::cout
#include <algorithm>    // std::replace_if
#include <vector>       // std::vector

bool IsOdd (int i) { return ((i%2)==1); }

int main () {
  std::vector<int> myvector;

  // set some values:
  for (int i=1; i<10; i++) myvector.push_back(i);               // 1 2 3 4 5 6 7 8 9

  std::replace_if (myvector.begin(), myvector.end(), IsOdd, 0); // 0 2 0 4 0 6 0 8 0

  std::cout << "myvector contains:";
  for (std::vector<int>::iterator it=myvector.begin(); it!=myvector.end(); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';

  return 0;
}

输出

myvector contains: 0 2 0 4 0 6 0 8 0

复杂度

线性与 first 和 last 之间的距离成正比：将 pred 应用于每个元素，并将值赋给匹配的元素。

数据竞争

范围 [first,last) 中的对象被访问并可能被修改。

异常

如果 pred、元素赋值或迭代器操作抛出异常，则此函数也抛出异常。
请注意，无效参数会导致 未定义行为。

另见

replace: 替换范围中的值（函数模板）

remove_if: 从范围中移除元素（函数模板）

transform: 转换范围（函数模板）

for_each: 将函数应用于范围（函数模板）

find_if: 在范围中查找元素（函数模板）