filled2dBy

Create a filled two-dimensional nested array according to a provided callback function.

Usage

var filled2dBy = require( '@stdlib/array/base/filled2d-by' );

filled2dBy( shape, clbk[, thisArg] )

Returns a filled two-dimensional nested array according to a provided callback function.

function clbk() {
    return 1.0;
}

var out = filled2dBy( [ 1, 3 ], clbk );
// returns [ [ 1.0, 1.0, 1.0 ] ]

When invoked, a callback function is provided a single argument:

indices: current array element indices.

To set the callback execution context, provide a thisArg.

function clbk() {
    this.count += 1;
    return 1.0;
}

var ctx = {
    'count': 0
};

var out = filled2dBy( [ 2, 3 ], clbk, ctx );
// returns [ [ 1.0, 1.0, 1.0 ], [ 1.0, 1.0, 1.0 ] ];

var cnt = ctx.count;
// returns 6

Examples

var constantFunction = require( '@stdlib/utils/constant-function' );
var filled2dBy = require( '@stdlib/array/base/filled2d-by' );

var out = filled2dBy( [ 1, 3 ], constantFunction( 0.0 ) );
// returns [ [ 0.0, 0.0, 0.0 ] ]

out = filled2dBy( [ 3, 1 ], constantFunction( 'beep' ) );
// returns [ [ 'beep' ], [ 'beep' ], [ 'beep' ] ]

out = filled2dBy( [ 1, 3 ], constantFunction( null ) );
// returns [ [ null, null, null ] ]

out = filled2dBy( [ 3, 1 ], constantFunction( true ) );
// returns [ [ true ], [ true ], [ true ] ]

out = filled2dBy( [ 1, 3 ], constantFunction( void 0 ) );
// returns [ [ undefined, undefined, undefined ] ]