time-to-botec/js/node_modules/@stdlib/assert/tools/array-function/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.5 KiB

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