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.
complex64: single-precision complex floating-point numbers.
complex128: double-precision complex 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 discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
var filledarrayBy = require( '@stdlib/array/filled-by' );
var dtypes = require( '@stdlib/array/dtypes' );
var convertArray = require( '@stdlib/array/convert' );

// Create a generic array:
var arr = filledarrayBy( 5, 'generic', discreteUniform( -100, 100 ) );

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

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