time-to-botec/js/node_modules/@stdlib/constants/array/max-array-length/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.6 KiB

Maximum Array Length

Maximum length for a generic array.

Usage

var MAX_ARRAY_LENGTH = require( '@stdlib/constants/array/max-array-length' );

MAX_ARRAY_LENGTH

Maximum length for a generic array.

var len = MAX_ARRAY_LENGTH;
// returns 4294967295

Examples

var MAX_ARRAY_LENGTH = require( '@stdlib/constants/array/max-array-length' );

function alloc( len ) {
    var arr;
    var i;
    if ( len > MAX_ARRAY_LENGTH ) {
        throw new RangeError( 'invalid argument. The maximum length for a generic array is '+MAX_ARRAY_LENGTH+'. To create a longer array-like data structure, consider either typed arrays or an array-like object.' );
    }
    // Manually allocate to ensure "fast" elements...
    arr = [];
    for ( i = 0; i < len; i++ ) {
        arr.push( 0 );
    }
    return arr;
}

var arr = alloc( 10 );
console.log( arr );

try {
    arr = alloc( 1e300 );
} catch ( err ) {
    console.error( err.message );
}