nextDataType
Return the next larger array data type of the same kind.
Usage
var nextDataType = require( '@stdlib/array/next-dtype' );
nextDataType( [dtype] )
If provided a dtype
argument, returns the next larger array data type of the same kind.
var out = nextDataType( 'float32' );
// returns 'float64'
If a data type does not have a next larger data type or the next larger data type is not supported, the function returns -1
.
var out = nextDataType( 'complex128' );
// returns -1
If not provided a dtype
argument, the function returns a table.
var out = nextDataType();
// returns {...}
If provided an unrecognized or unsupported dtype
, the function returns null
.
var out = nextDataType( 'foo' );
// returns null
Examples
var dtypes = require( '@stdlib/array/dtypes' );
var nextDataType = require( '@stdlib/array/next-dtype' );
var DTYPES;
var dt;
var i;
// Get the list of supported array data types:
DTYPES = dtypes();
// Print the next larger data type for each supported data type...
for ( i = 0; i < DTYPES.length; i++ ) {
dt = nextDataType( DTYPES[ i ] );
console.log( '%s => %s', DTYPES[ i ], dt );
}