time-to-botec/js/node_modules/@stdlib/assert/tools/array-function/README.md

Array Function

Return a function which tests if every element in an array passes a test condition.

Usage

var arrayfcn = require( '@stdlib/assert/tools/array-function' );

arrayfcn( predicate )

Returns a function which tests if every element in an array passes a test condition. Given an input array, the function returns true if all elements pass the test and false otherwise.

var isOdd = require( '@stdlib/assert/is-odd' );

var arr1 = [ 1, 3, 5, 7 ];
var arr2 = [ 3, 5, 8 ];

var f = arrayfcn( isOdd );

var bool = f( arr1 );
// returns true

bool = f( arr2 );
// returns false

Notes

• The returned function will return false if not provided an array.
• The returned function will return false if provided an empty array.
• A predicate function should accept a single argument: an array element. If the array element satisfies a test condition, the predicate function should return true; otherwise, the predicate function should return false.

Examples

var isEven = require( '@stdlib/assert/is-even' );
var arrayfcn = require( '@stdlib/assert/tools/array-function' );

var arr1;
var arr2;
var bool;
var f;
var i;

arr1 = new Array( 25 );
for ( i = 0; i < arr1.length; i++ ) {
    arr1[ i ] = i;
}

arr2 = new Array( 25 );
for ( i = 0; i < arr2.length; i++ ) {
    arr2[ i ] = 2 * i;
}

f = arrayfcn( isEven );

bool = f( arr1 );
// returns false

bool = f( arr2 );
// returns true