fullLike
Create a filled array having the same length and data type as a provided array.
Usage
var fullLike = require( '@stdlib/array/full-like' );
fullLike( x, value[, dtype] )
Creates a filled array having the same length and data type as a provided array x
.
var x = [ 1, 2, 3, 4, 5 ];
var arr = fullLike( x, 1 );
// returns [ 1, 1, 1, 1, 1 ]
The function supports the following data types:
float64
: double-precision floating-point numbers (IEEE 754)float32
: single-precision floating-point numbers (IEEE 754)complex128
: double-precision complex floating-point numberscomplex64
: single-precision complex floating-point numbersint32
: 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
generic
: generic JavaScript values
By default, the output array data type is inferred from the provided array x
. To return an array having a different data type, provide a dtype
argument.
var x = [ 1, 1 ];
var arr = fullLike( x, 1, 'int32' );
// returns <Int32Array>[ 1, 1 ]
Notes
- If provided a number and the output array data type is a complex number data type, the function returns a complex number array where each element has a real component whose value equals the provided fill value and where each element has an imaginary component equal to
0
.
Examples
var dtypes = require( '@stdlib/array/dtypes' );
var zeros = require( '@stdlib/array/zeros' );
var fullLike = require( '@stdlib/array/full-like' );
// Create a zero-filled array:
var x = zeros( 4, 'complex128' );
// Get a list of array data types:
var dt = dtypes();
// Generate filled arrays...
var y;
var i;
for ( i = 0; i < dt.length; i++ ) {
y = fullLike( x, 1.0, dt[ i ] );
console.log( y );
}