time-to-botec/js/node_modules/@stdlib/ndarray/index-modes/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.8 KiB

Index Modes

List of ndarray index modes.

Usage

var modes = require( '@stdlib/ndarray/index-modes' );

modes()

Returns a list of ndarray index modes.

var out = modes();
// returns [ 'throw', 'clamp', 'wrap' ]

The output array contains the following modes:

  • throw: specifies that a function should throw an error when an index is outside a restricted interval.
  • wrap: specifies that a function should wrap around an index using modulo arithmetic.
  • clamp: specifies that a function should set an index less than 0 to 0 (minimum index) and set an index greater than a maximum index value to the maximum possible index.

Examples

var indexOf = require( '@stdlib/utils/index-of' );
var modes = require( '@stdlib/ndarray/index-modes' );

var MODES = modes();
var bool;

function isMode( str ) {
    if ( indexOf( MODES, str ) === -1 ) {
        return false;
    }
    return true;
}

bool = isMode( 'throw' );
// returns true

bool = isMode( 'clamp' );
// returns true

bool = isMode( 'wrap' );
// returns true

bool = isMode( 'beep' );
// returns false