Home C&C++函数库 c++ 语法 程序源码 Linux C库

std::

replace_if

函数模板  <algorithm>
template <class ForwardIterator, class UnaryPredicate, class T>
  void replace_if (ForwardIterator first, ForwardIterator last,
                   UnaryPredicate pred, const T& new_value );

替换范围内的值

将new_value赋给[first,last]范围内pred返回true的所有元素。

这个函数模板的行为相当于:
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
指向一个支持比较和赋值为T类型序列的初始和最终位置的前向迭代器。 使用的范围是[first,last), 它包含first和last之间的所有元素,包括first指向的元素,但不包括last指向的元素。

pred
一个一元函数,它接受范围中的一个元素作为参数,并返回一个可转换为bool的值。 返回的值指示是否要替换元素(如果为true,则替换)。

函数不应修改参数。

它可以是函数指针,也可以是函数对象。

new_value
赋给被替换元素的值。

☉  返回值



none

☣  示例



// 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

✥ 复杂度



first1和last1之间的线性距离:对每个元素应用pred并赋值给那些匹配的元素。

⇄ 数据竞争


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

☂ 异常安全性



如果pred、元素赋值或迭代器上的任何操作抛出,则抛出。
注意,无效的参数会导致未定义的行为。

🍄  另请参阅



replace 替换范围内的值(函数模板)
remove_if 检查并覆盖范围中的值(函数模板)
transform 改变范围(函数模板)
for_each 将函数应用于范围(函数模板)
find_if 在范围内查找元素(函数模板)

联系我们 免责声明 关于CandCplus 网站地图