time-to-botec/js/node_modules/@stdlib/utils/any/README.md
NunoSempere b6addc7f05 feat: add the node modules
Necessary in order to clearly see the squiggle hotwiring.
2022-12-03 12:44:49 +00:00

2.9 KiB

any

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 collection may be either an Array, Typed Array, or an array-like Object (excluding strings and functions).
  • The function does not skip undefined elements 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>