Typed Arrays
Create a typed array.
Usage
var realarray = require( '@stdlib/array/typed-real' );
realarray( [dtype] )
Creates a typed array having a specified data type dtype
.
var arr = realarray();
// returns <Float64Array>
The function recognizes the following data types:
float64
: double-precision floating-point numbers (IEEE 754)float32
: single-precision floating-point numbers (IEEE 754)int32
: 32-bit two's complement signed integersuint32
: 32-bit unsigned integersint16
: 16-bit two's complement signed integersuint16
: 16-bit unsigned integersint8
: 8-bit two's complement signed integersuint8
: 8-bit unsigned integersuint8c
: 8-bit unsigned integers clamped to0-255
By default, the output typed array data type is float64
. To specify an alternative data type, provide a dtype
argument.
var arr = realarray( 'int32' );
// returns <Int32Array>
realarray( length[, dtype] )
Returns a typed array having a specified length
.
var arr1 = realarray( 5 );
// returns <Float64Array>[ 0.0, 0.0, 0.0, 0.0, 0.0 ]
var arr2 = realarray( 5, 'uint8' );
// returns <Uint8Array>[ 0, 0, 0, 0, 0 ]
realarray( realarray[, dtype] )
Creates a typed array from another typed array.
var arr1 = realarray( [ 5.0, -3.0, 2.0 ] );
// returns <Float64Array>[ 5.0, -3.0, 2.0 ]
var arr2 = realarray( arr1 );
// returns <Float64Array>[ 5.0, -3.0, 2.0 ]
var arr3 = realarray( arr1, 'int32' );
// returns <Int32Array>[ 5, -3, 2 ]
realarray( obj[, dtype] )
Creates a typed array from an array-like object or iterable.
var arr1 = realarray( [ 0.5, 0.5, 0.5 ] );
// returns <Float64Array>[ 0.5, 0.5, 0.5 ]
var arr2 = realarray( [ 0.5, 0.5, 0.5 ], 'float32' );
// returns <Float32Array>[ 0.5, 0.5, 0.5 ]
realarray( buffer[, byteOffset[, length]][, dtype] )
Returns a typed array view of an ArrayBuffer
.
var ArrayBuffer = require( '@stdlib/array/buffer' );
var buf = new ArrayBuffer( 32 );
var arr1 = realarray( buf );
// returns <Float64Array>[ 0.0, 0.0, 0.0, 0.0 ]
var arr2 = realarray( buf, 'float32' );
// returns <Float32Array>[ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ]
var arr3 = realarray( buf, 16 );
// returns <Float64Array>[ 0.0, 0.0 ]
var arr4 = realarray( buf, 16, 'float32' );
// returns <Float32Array>[ 0.0, 0.0, 0.0, 0.0 ]
var arr5 = realarray( buf, 16, 1 );
// returns <Float64Array>[ 0.0 ]
var arr6 = realarray( buf, 10, 4, 'int16' );
// returns <Int16Array>[ 0, 0, 0, 0 ]
Examples
var randu = require( '@stdlib/random/base/randu' );
var realarray = require( '@stdlib/array/typed-real' );
var arr = realarray( 100, 'float64' );
var i;
for ( i = 0; i < arr.length; i++ ) {
arr[ i ] = randu() * 100.0;
}
console.log( arr );