README.md

cfill

Fill a complex single-precision floating-point ndarray with a specified scalar constant.

Usage

var cfill = require( '@stdlib/blas/ext/base/ndarray/cfill' );

cfill( arrays )

Fills a complex single-precision floating-point ndarray x with a specified scalar constant alpha.

var Complex64Array = require( '@stdlib/array/complex64' );
var Complex64 = require( '@stdlib/complex/float32/ctor' );
var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var ndarray = require( '@stdlib/ndarray/ctor' );

var buffer = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0 ] );
var x = new ndarray( 'complex64', buffer, [ 2 ], [ 1 ], 0, 'row-major' );

var alpha = scalar2ndarray( new Complex64( 10.0, 10.0 ), {
    'dtype': 'complex64'
});

var out = cfill( [ x, alpha ] );
// returns <ndarray>

var arr = ndarray2array( out );
// returns [ <Complex64>[ 10.0, 10.0 ], <Complex64>[ 10.0, 10.0 ] ]

The function has the following parameters:

• arrays: array-like object containing a single one-dimensional input ndarray and a zero-dimensional ndarray containing a scalar constant.

Examples

var Complex64Array = require( '@stdlib/array/complex64' );
var Complex64 = require( '@stdlib/complex/float32/ctor' );
var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
var ndarray = require( '@stdlib/ndarray/ctor' );
var realf = require( '@stdlib/complex/float32/real' );
var imagf = require( '@stdlib/complex/float32/imag' );
var cfill = require( '@stdlib/blas/ext/base/ndarray/cfill' );

var buffer = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
var x = new ndarray( 'complex64', buffer, [ 3 ], [ 1 ], 0, 'row-major' );

var alpha = scalar2ndarray( new Complex64( 10.0, 10.0 ), {
    'dtype': 'complex64'
});

cfill( [ x, alpha ] );

var v = x.get( 0 );
console.log( 'x[0] = %d + %di', realf( v ), imagf( v ) );
// => 'x[0] = 10 + 10i'

v = x.get( 1 );
console.log( 'x[1] = %d + %di', realf( v ), imagf( v ) );
// => 'x[1] = 10 + 10i'

v = x.get( 2 );
console.log( 'x[2] = %d + %di', realf( v ), imagf( v ) );
// => 'x[2] = 10 + 10i'