std::
any_of
函数模板 <algorithm>
template <class InputIterator, class UnaryPredicate>
bool any_of (InputIterator first, InputIterator last, UnaryPredicate pred); |
测试范围中是否有满足条件的元素
如果pred对[first,last]范围内的任何元素返回true,则返回true,否则返回false。
如果[first,last)是一个空范围,函数返回false。
这个函数模板的行为相当于:
template<class InputIterator, class UnaryPredicate>
bool any_of (InputIterator first, InputIterator last, UnaryPredicate pred)
{
while (first!=last) {
if (pred(*first)) return true;
++first;
}
return false;
} |
☲ 参数
-
first, last
-
指向序列初始和最终位置的输入迭代器。使用的范围是[first,last],
它包含first和last之间的所有元素,包括first指向的元素,但不包括last指向的元素。
-
pred
-
接受范围内元素作为参数并返回可转换为bool的值的一元函数。
返回的值指示元素是否满足该函数检查的条件。
函数不应修改其参数。
它可以是函数指针,也可以是函数对象。
☉ 返回值
如果pred对[first,last]范围内的任何元素返回True,则为真,否则为假。
如果[first,last)是一个空范围,函数返回false。
☣ 示例
// any_of example
#include <iostream> // std::cout
#include <algorithm> // std::any_of
#include <array> // std::array
int main () {
std::array<int,7> foo = {0,1,-1,3,-3,5,-5};
if ( std::any_of(foo.begin(), foo.end(), [](int i){return i<0;}) )
std::cout << "There are negative elements in the range.\n";
return 0;
} |
输出:
There are negative elements in the range.
✥ 复杂度
在first 和last之间的distance达到线性:对每个元素调用pred,直到发现匹配。
⇄ 数据竞争
[first,last)范围内的部分(或全部)对象被访问(最多一次)。
☂ 异常安全性
如果迭代器上的pred或操作抛出,则抛出。
注意,无效的参数会导致未定义的行为。
🍄 另请参阅
all_of |
测试范围内所有元素的情况(函数模板) |
none_of |
测试是否没有元素满足条件(函数模板) |
find_if |
在范围内查找元素(函数模板) |