Test whether at least one element in a collection is truthy.
Usage
var any = require( '@stdlib/utils/any' );
any( collection )
Tests whether at least one element in a collection is truthy.
var arr = [ 0, 0, 0, 0, 1 ]; var bool = any( arr ); // returns true
If provided an empty collection, the function returns false.
var bool = any( [] ); // returns false
Notes
- A
collectionmay be either anArray,Typed Array, or an array-likeObject(excludingstringsandfunctions). - The function does not skip
undefinedelements and is thus not optimized for sparse collections.
Examples
var randu = require( '@stdlib/random/base/randu' ); var any = require( '@stdlib/utils/any' ); var bool; var arr; var i; arr = []; for ( i = 0; i < 100; i++ ) { arr.push( ( randu() > 0.95 ) ); } bool = any( arr ); // returns <boolean>
See Also
@stdlib/utils/any-by: test whether at least one element in a collection passes a test implemented by a predicate function.@stdlib/utils/every: test whether all elements in a collection are truthy.@stdlib/utils/for-each: invoke a function for each element in a collection.@stdlib/utils/none: test whether all elements in a collection are falsy.@stdlib/utils/some: test whether a collection contains at leastnelements which are truthy.