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 = new Array( 5 );
var i;
for ( i = 0; i < arr.length; i++ ) {
    arr[ i ] = 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 );
}