time-to-botec/squiggle/node_modules/@stdlib/array/convert/README.md

Convert

Convert an array to an array of a different data type.

Usage

var convertArray = require( '@stdlib/array/convert' );

convertArray( arr, dtype )

Converts an array to an array of a different data type.

var arr = [ 1.0, 2.0, 3.0 ];
var out = convertArray( arr, 'float32' );
// returns <Float32Array>[ 1.0, 2.0, 3.0 ]

The function supports the following data types:

• float32: single-precision floating-point numbers.
• float64: double-precision floating-point numbers.
• generic: values of any type.
• int16: signed 16-bit integers.
• int32: signed 32-bit integers.
• int8: signed 8-bit integers.
• uint16: unsigned 16-bit integers.
• uint32: unsigned 32-bit integers.
• uint8: unsigned 8-bit integers.
• uint8c: unsigned clamped 8-bit integers.

Examples

var dtypes = require( '@stdlib/array/dtypes' );
var randu = require( '@stdlib/random/base/randu' );
var floor = require( '@stdlib/math/base/special/floor' );
var convertArray = require( '@stdlib/array/convert' );

// Create a generic array:
var arr = [];
var i;
for ( i = 0; i < 5; i++ ) {
    arr.push( floor( randu()*1.0e25 ) - 5.0e24 );
}

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

// Convert the generic array to each array data type:
var out;
for ( i = 0; i < DTYPES.length; i++ ) {
    out = convertArray( arr, DTYPES[ i ] );
    console.log( out );
}