empty

Create an uninitialized array having a specified length.

Usage

var empty = require( '@stdlib/array/empty' );

empty( length[, dtype] )

Creates an uninitialized array having a specified length.

var arr = empty( 2 );
// returns <Float64Array>

By default, the output array data type is float64 (i.e., a typed array). To specify an alternative data type, provide a dtype argument.

var arr = empty( 2, 'int32' );
// returns <Int32Array>

Notes

• In browser environments, the function always returns zero-filled arrays.
• If dtype is 'generic', the function always returns a zero-filled array.
• In Node.js versions >=3.0.0, the underlying memory of returned typed arrays is not initialized. Memory contents are unknown and may contain sensitive data.

Examples

var dtypes = require( '@stdlib/array/dtypes' );
var empty = require( '@stdlib/array/empty' );

// Get a list of array data types:
var dt = dtypes();

// Generate empty arrays...
var arr;
var i;
for ( i = 0; i < dt.length; i++ ) {
    arr = empty( 4, dt[ i ] );
    console.log( arr );
}

---

See Also

• @stdlib/array/empty-like: create an uninitialized array having the same length and data type as a provided array.
• @stdlib/array/full: create a filled array having a specified length.
• @stdlib/array/ones: create an array filled with ones and having a specified length.
• @stdlib/array/zeros: create a zero-filled array having a specified length.
• @stdlib/ndarray/empty: create an uninitialized ndarray having a specified shape and data type.