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

std::

all_of

函数模板  <algorithm>
template <class InputIterator, class UnaryPredicate>
  bool all_of (InputIterator first, InputIterator last, UnaryPredicate pred);

测试范围内所有元素的情况

如果pred对范围[first,last]中的所有元素返回true,或者范围为空,则返回true,否则返回false。

这个函数模板的行为相当于:

template<class InputIterator, class UnaryPredicate>
  bool all_of (InputIterator first, InputIterator last, UnaryPredicate pred)
{
  while (first!=last) {
    if (!pred(*first)) return false;
    ++first;
  }
  return true;
}

☲  参数


first, last
指向序列初始和最终位置的输入迭代器。使用的范围是[first,last], 它包含first和last之间的所有元素,包括first指向的元素,但不包括last指向的元素。
pred
接受范围内元素作为参数并返回可转换为bool的值的一元函数。 返回的值指示元素是否满足该函数检查的条件。
函数不应修改其参数。
它可以是函数指针,也可以是函数对象。

☉  返回值



如果pred对该范围内的所有元素返回True,或者该范围为空则返回True,否则返回false。

☣  示例



// all_of example
#include <iostream>     // std::cout
#include <algorithm>    // std::all_of
#include <array>        // std::array

int main () {
  std::array<int,8> foo = {3,5,7,11,13,17,19,23};

  if ( std::all_of(foo.begin(), foo.end(), [](int i){return i%2;}) )
    std::cout << "All the elements are odd numbers.\n";

  return 0;
}

输出:
All the elements are odd numbers.

✥ 复杂度



在first 和last之间的distance达到线性:对每个元素调用pred,直到发现不匹配。

⇄ 数据竞争


[first,last)范围内的部分(或全部)对象被访问(最多一次)。

☂ 异常安全性



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

🍄  另请参阅



any_of 测试范围内是否有满足条件的元素(函数模板)
none_of 测试是否没有元素满足条件(函数模板)
find_if 在范围内查找元素(函数模板)

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