README.md

gfill

Fill a one-dimensional ndarray with a specified value.

Usage

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

gfill( arrays )

Fills a one-dimensional ndarray x with a specified value alpha.

var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var ndarray = require( '@stdlib/ndarray/base/ctor' );

var xbuf = [ 1.0, 2.0, 3.0, 4.0 ];
var x = new ndarray( 'generic', xbuf, [ 4 ], [ 1 ], 0, 'row-major' );

var alpha = scalar2ndarray( 5.0, {
    'dtype': 'generic'
});

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

var arr = ndarray2array( out );
// returns [ 5.0, 5.0, 5.0, 5.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 discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var scalar2ndarray = require( '@stdlib/ndarray/from-scalar' );
var ndarray2array = require( '@stdlib/ndarray/to-array' );
var ndarray = require( '@stdlib/ndarray/base/ctor' );
var gfill = require( '@stdlib/blas/ext/base/ndarray/gfill' );

var xbuf = discreteUniform( 10, -50, 50, {
    'dtype': 'generic'
});
var x = new ndarray( 'generic', xbuf, [ xbuf.length ], [ 1 ], 0, 'row-major' );

console.log( 'Before:' );
console.log( ndarray2array( x ) );

var alpha = scalar2ndarray( 5.0, {
    'dtype': 'generic'
});

gfill( [ x, alpha ] );

console.log( 'After:' );
console.log( ndarray2array( x ) );