头文件'boost / algorithm / cxx11 / any_of.hpp'包含单个算法any_of的四个变体。 该算法测试序列的元素,如果任何元素具有特定属性,则返回true。
例程any_of采用序列和谓词。 如果谓词对于序列中的任何元素返回true,它将返回true。
例程any_of_equal需要一个序列和一个值。 如果序列中的任何元素比较等于传入的值,它将返回true。
这两个例程有两种形式; 第一个需要两个迭代器来定义范围。 第二种形式采用单一范围参数,并使用Boost.Range来遍历它。
一、接口
如果谓词返回true,则函数any_of返回true。 有两个版本 一个需要两个迭代器,另一个需要一个范围。
namespace boost { namespace algorithm {
template
bool any_of ( InputIterator first, InputIterator last, Predicate p );
template
bool any_of ( const Range &r, Predicate p );
}}
namespace boost { namespace algorithm {
template
bool any_of_equal ( InputIterator first, InputIterator last, V const &val );
template
bool any_of_equal ( const Range &r, V const &val );
}}
二、实例
给定包含{0,1,2,3,14,15}的容器c
bool isOdd ( int i ) { return i % 2 == 1; }
bool lessThan10 ( int i ) { return i < 10; }
using boost::algorithm;
any_of ( c, isOdd ) --> true
any_of ( c.begin (), c.end (), lessThan10 ) --> true
any_of ( c.begin () + 4, c.end (), lessThan10 ) --> false
any_of ( c.end (), c.end (), isOdd ) --> false // empty range
any_of_equal ( c, 3 ) --> true
any_of_equal ( c.begin (), c.begin () + 3, 3 ) --> false
any_of_equal ( c.begin (), c.begin (), 99 ) --> false // empty range
除了输出迭代器之外,所有迭代器都有any_of和any_of_equal。
四、复杂度
any_of和any_of_equal的所有变体都以O(N)(线性)时间运行; 也就是说,它们与列表中的每个元素进行比较。 如果任何比较成功,算法将立即终止,而不检查序列的剩余成员。
五、安全异常
any_of和any_of_equal的所有变体都通过value或const引用来获取它们的参数,而不依赖于任何全局状态。 因此,此文件中的所有例程都提供强大的异常保证。
六、注意
1、例程any_of也可作为C ++ 11标准的一部分。
2、any_of和any_of_equal都为空范围返回false,无论通过什么进行测试。
3、any_of_value的第二个参数是一个模板参数,而不是从第一个参数(std :: iterator_traits