diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/README.md b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/README.md index 0be461884689..0727ddc6f677 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/README.md +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/README.md @@ -54,8 +54,16 @@ var alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); -gfillEqual( [ x, searchElement, alpha ] ); -// x => [ 5.0, -2.0, 3.0, 5.0, 4.0, -6.0 ] +var start = scalar2ndarray( 0, { + 'dtype': 'generic' +}); + +var end = scalar2ndarray( 2, { + 'dtype': 'generic' +}); + +gfillEqual( [ x, searchElement, alpha, start, end ] ); +// x => [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] ``` The function has the following parameters: @@ -65,6 +73,8 @@ The function has the following parameters: - a one-dimensional input ndarray. - a zero-dimensional ndarray containing the search element. - a zero-dimensional ndarray containing the scalar constant. + - a zero-dimensional ndarray containing the starting index (inclusive). + - a zero-dimensional ndarray containing the ending index (exclusive). @@ -75,6 +85,7 @@ The function has the following parameters: ## Notes - The input ndarray is modified **in-place** (i.e., the input ndarray is **mutated**). +- If a specified `start` or `end` index is negative, the function resolves the respective index by counting backward from the last element (where `-1` refers to the last element). - When comparing elements, the function checks for equality using the strict equality operator `===`. As a consequence, `NaN` values are considered distinct (i.e., as `NaN === NaN` always evaluates to `false`, `NaN` elements are never replaced), and `-0` and `+0` are considered the same. @@ -98,7 +109,7 @@ var opts = { 'dtype': 'generic' }; -var x = discreteUniform( [ 10 ], 0, 3, opts ); +var x = discreteUniform( [ 20 ], 0, 3, opts ); console.log( ndarray2array( x ) ); var searchElement = scalar2ndarray( 1, opts ); @@ -107,7 +118,13 @@ console.log( 'Search Element: %d', ndarraylike2scalar( searchElement ) ); var alpha = scalar2ndarray( 5, opts ); console.log( 'Alpha: %d', ndarraylike2scalar( alpha ) ); -gfillEqual( [ x, searchElement, alpha ] ); +var start = scalar2ndarray( 5, opts ); +console.log( 'Start Index: %d', ndarraylike2scalar( start ) ); + +var end = scalar2ndarray( 15, opts ); +console.log( 'End Index: %d', ndarraylike2scalar( end ) ); + +gfillEqual( [ x, searchElement, alpha, start, end ] ); console.log( ndarray2array( x ) ); ``` diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/benchmark/benchmark.js index 9915b489eac3..eb461c214cfe 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/benchmark/benchmark.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/benchmark/benchmark.js @@ -48,11 +48,15 @@ var options = { function createBenchmark( len ) { var searchElement; var alpha; + var start; + var end; var x; x = uniform( [ len ], -100.0, 100.0, options ); searchElement = scalar2ndarray( 0.0, options ); alpha = scalar2ndarray( 5.0, options ); + start = scalar2ndarray( 0, options ); + end = scalar2ndarray( len, options ); return benchmark; /** @@ -67,7 +71,7 @@ function createBenchmark( len ) { b.tic(); for ( i = 0; i < b.iterations; i++ ) { - out = gfillEqual( [ x, searchElement, alpha ] ); + out = gfillEqual( [ x, searchElement, alpha, start, end ] ); if ( typeof out !== 'object' ) { b.fail( 'should return an ndarray' ); } diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/repl.txt b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/repl.txt index 147e58c3f2fd..1a4b176781e5 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/repl.txt +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/repl.txt @@ -6,6 +6,10 @@ The input ndarray is modified *in-place* (i.e., the input ndarray is *mutated*). + If a specified `start` or `end` index is negative, the function resolves + the respective index by counting backward from the last element (where `-1` + refers to the last element). + When comparing elements, the function checks for equality using the strict equality operator `===`. As a consequence, `NaN` values are considered distinct (i.e., as `NaN === NaN` always evaluates to `false`, `NaN` elements @@ -19,6 +23,8 @@ - a one-dimensional input ndarray. - a zero-dimensional ndarray containing the search element. - a zero-dimensional ndarray containing the scalar constant. + - a zero-dimensional ndarray containing the starting index (inclusive). + - a zero-dimensional ndarray containing the ending index (exclusive). Returns ------- @@ -32,8 +38,10 @@ > var opts = { 'dtype': 'generic' }; > var v = {{alias:@stdlib/ndarray/from-scalar}}( 0.0, opts ); > var alpha = {{alias:@stdlib/ndarray/from-scalar}}( 5.0, opts ); - > {{alias}}( [ x, v, alpha ] ) - [ 5.0, -2.0, 3.0, 5.0, 4.0, -6.0 ] + > var st = {{alias:@stdlib/ndarray/from-scalar}}( 0, opts ); + > var en = {{alias:@stdlib/ndarray/from-scalar}}( 2, opts ); + > {{alias}}( [ x, v, alpha, st, en ] ) + [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] See Also -------- diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/types/index.d.ts b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/types/index.d.ts index 8b95ab75ccfe..e640083c3778 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/types/index.d.ts +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/types/index.d.ts @@ -32,6 +32,8 @@ import { typedndarray } from '@stdlib/types/ndarray'; * - a one-dimensional input ndarray. * - a zero-dimensional ndarray containing the search element. * - a zero-dimensional ndarray containing the scalar constant. +* - a zero-dimensional ndarray containing the starting index (inclusive). +* - a zero-dimensional ndarray containing the ending index (exclusive). * * - When comparing elements, the function checks for equality using the strict equality operator `===`. As a consequence, `NaN` values are considered distinct (i.e., as `NaN === NaN` always evaluates to `false`, `NaN` elements are never replaced), and `-0` and `+0` are considered the same. * @@ -52,10 +54,18 @@ import { typedndarray } from '@stdlib/types/ndarray'; * 'dtype': 'generic' * }); * -* var out = gfillEqual( [ x, searchElement, alpha ] ); -* // returns [ 5.0, -2.0, 3.0, 5.0, 4.0, -6.0 ] +* var start = scalar2ndarray( 0, { +* 'dtype': 'generic' +* }); +* +* var end = scalar2ndarray( 2, { +* 'dtype': 'generic' +* }); +* +* var out = gfillEqual( [ x, searchElement, alpha, start, end ] ); +* // returns [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] */ -declare function gfillEqual = typedndarray>( arrays: [ T, typedndarray, typedndarray ] ): T; +declare function gfillEqual = typedndarray>( arrays: [ T, typedndarray, typedndarray, typedndarray, typedndarray ] ): T; // EXPORTS // diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/types/test.ts b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/types/test.ts index 3843a417908d..59ec19c446a6 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/types/test.ts +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/docs/types/test.ts @@ -36,8 +36,14 @@ import gfillEqual = require( './index' ); const alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + const start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + const end = scalar2ndarray( 10, { + 'dtype': 'generic' + }); - gfillEqual( [ x, searchElement, alpha ] ); // $ExpectType genericndarray + gfillEqual( [ x, searchElement, alpha, start, end ] ); // $ExpectType genericndarray } // The compiler throws an error if the function is provided a first argument which is not an array of ndarrays... @@ -64,7 +70,13 @@ import gfillEqual = require( './index' ); const alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + const start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + const end = scalar2ndarray( 10, { + 'dtype': 'generic' + }); gfillEqual(); // $ExpectError - gfillEqual( [ x, searchElement, alpha ], {} ); // $ExpectError + gfillEqual( [ x, searchElement, alpha, start, end ], {} ); // $ExpectError } diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/examples/index.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/examples/index.js index 7736f2f26f0d..9bf36dd4ec55 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/examples/index.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/examples/index.js @@ -28,7 +28,7 @@ var opts = { 'dtype': 'generic' }; -var x = discreteUniform( [ 10 ], 0, 3, opts ); +var x = discreteUniform( [ 20 ], 0, 3, opts ); console.log( ndarray2array( x ) ); var searchElement = scalar2ndarray( 1, opts ); @@ -37,5 +37,11 @@ console.log( 'Search Element: %d', ndarraylike2scalar( searchElement ) ); var alpha = scalar2ndarray( 5, opts ); console.log( 'Alpha: %d', ndarraylike2scalar( alpha ) ); -gfillEqual( [ x, searchElement, alpha ] ); +var start = scalar2ndarray( 5, opts ); +console.log( 'Start Index: %d', ndarraylike2scalar( start ) ); + +var end = scalar2ndarray( 15, opts ); +console.log( 'End Index: %d', ndarraylike2scalar( end ) ); + +gfillEqual( [ x, searchElement, alpha, start, end ] ); console.log( ndarray2array( x ) ); diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/lib/index.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/lib/index.js index 71f744bbdfdc..7f89a84161a4 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/lib/index.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/lib/index.js @@ -38,8 +38,16 @@ * 'dtype': 'generic' * }); * -* var out = gfillEqual( [ x, searchElement, alpha ] ); -* // returns [ 5.0, -2.0, 3.0, 5.0, 4.0, -6.0 ] +* var start = scalar2ndarray( 0, { +* 'dtype': 'generic' +* }); +* +* var end = scalar2ndarray( 2, { +* 'dtype': 'generic' +* }); +* +* var out = gfillEqual( [ x, searchElement, alpha, start, end ] ); +* // returns [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] */ // MODULES // diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/lib/main.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/lib/main.js index fef094af4380..e333258d6123 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/lib/main.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/lib/main.js @@ -21,11 +21,12 @@ // MODULES // var numelDimension = require( '@stdlib/ndarray/base/numel-dimension' ); +var clipIndex = require( '@stdlib/ndarray/base/clip-index' ); var getStride = require( '@stdlib/ndarray/base/stride' ); var getOffset = require( '@stdlib/ndarray/base/offset' ); var getData = require( '@stdlib/ndarray/base/data-buffer' ); -var strided = require( '@stdlib/blas/ext/base/gfill-equal' ).ndarray; var ndarraylike2scalar = require( '@stdlib/ndarray/base/ndarraylike2scalar' ); +var strided = require( '@stdlib/blas/ext/base/gfill-equal' ).ndarray; // MAIN // @@ -40,6 +41,8 @@ var ndarraylike2scalar = require( '@stdlib/ndarray/base/ndarraylike2scalar' ); * - a one-dimensional input ndarray. * - a zero-dimensional ndarray containing the search element. * - a zero-dimensional ndarray containing the scalar constant. +* - a zero-dimensional ndarray containing the starting index (inclusive). +* - a zero-dimensional ndarray containing the ending index (exclusive). * * - When comparing elements, the function checks for equality using the strict equality operator `===`. As a consequence, `NaN` values are considered distinct (i.e., as `NaN === NaN` always evaluates to `false`, `NaN` elements are never replaced), and `-0` and `+0` are considered the same. * @@ -60,18 +63,41 @@ var ndarraylike2scalar = require( '@stdlib/ndarray/base/ndarraylike2scalar' ); * 'dtype': 'generic' * }); * -* var out = gfillEqual( [ x, searchElement, alpha ] ); -* // returns [ 5.0, -2.0, 3.0, 5.0, 4.0, -6.0 ] +* var start = scalar2ndarray( 0, { +* 'dtype': 'generic' +* }); +* +* var end = scalar2ndarray( 2, { +* 'dtype': 'generic' +* }); +* +* var out = gfillEqual( [ x, searchElement, alpha, start, end ] ); +* // returns [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] */ function gfillEqual( arrays ) { var searchElement; + var stride; + var offset; var alpha; + var start; + var end; + var N; var x; x = arrays[ 0 ]; searchElement = ndarraylike2scalar( arrays[ 1 ] ); alpha = ndarraylike2scalar( arrays[ 2 ] ); - strided( numelDimension( x, 0 ), searchElement, alpha, getData( x ), getStride( x, 0 ), getOffset( x ) ); // eslint-disable-line max-len + + N = numelDimension( x, 0 ); + start = clipIndex( ndarraylike2scalar( arrays[ 3 ] ), N ); + end = clipIndex( ndarraylike2scalar( arrays[ 4 ] ), N ); + if ( start >= end ) { + return x; + } + stride = getStride( x, 0 ); + offset = getOffset( x ) + ( stride*start ); + + strided( end-start, searchElement, alpha, getData( x ), stride, offset ); return x; } diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/test/test.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/test/test.js index 9a02b5f0e870..ffdb5e14f2d3 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/test/test.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/gfill-equal/test/test.js @@ -57,7 +57,9 @@ tape( 'the function replaces elements equal to a provided search element', funct var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ]; @@ -68,8 +70,14 @@ tape( 'the function replaces elements equal to a provided search element', funct alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 6, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ 5.0, -2.0, 3.0, 5.0, 4.0, -6.0 ]; @@ -83,7 +91,9 @@ tape( 'the function supports an input ndarray having a non-unit stride', functio var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ]; @@ -94,8 +104,14 @@ tape( 'the function supports an input ndarray having a non-unit stride', functio alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ]; @@ -109,7 +125,9 @@ tape( 'the function supports an input ndarray having a negative stride', functio var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ]; @@ -120,8 +138,14 @@ tape( 'the function supports an input ndarray having a negative stride', functio alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ]; @@ -135,7 +159,9 @@ tape( 'the function supports an input ndarray having a non-zero offset', functio var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ]; @@ -146,8 +172,14 @@ tape( 'the function supports an input ndarray having a non-zero offset', functio alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ 0.0, -2.0, 3.0, 5.0, 4.0, -6.0 ]; @@ -156,12 +188,281 @@ tape( 'the function supports an input ndarray having a non-zero offset', functio t.end(); }); +tape( 'the function supports a nonnegative starting index', function test( t ) { + var searchElement; + var expected; + var actual; + var alpha; + var start; + var xbuf; + var end; + var x; + + xbuf = [ 0.0, 0.0, 0.0, 0.0 ]; + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'generic' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'generic' + }); + start = scalar2ndarray( 1, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); + + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = [ 0.0, 5.0, 5.0, 5.0 ]; + t.deepEqual( xbuf, expected, 'returns expected value' ); + + t.end(); +}); + +tape( 'the function supports a negative starting index', function test( t ) { + var searchElement; + var expected; + var actual; + var alpha; + var start; + var xbuf; + var end; + var x; + + xbuf = [ 0.0, 0.0, 0.0, 0.0 ]; + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'generic' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'generic' + }); + start = scalar2ndarray( -3, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); + + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = [ 0.0, 5.0, 5.0, 5.0 ]; + t.deepEqual( xbuf, expected, 'returns expected value' ); + + t.end(); +}); + +tape( 'the function supports a nonnegative ending index', function test( t ) { + var searchElement; + var expected; + var actual; + var alpha; + var start; + var xbuf; + var end; + var x; + + xbuf = [ 0.0, 0.0, 0.0, 0.0 ]; + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'generic' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'generic' + }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); + + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = [ 5.0, 5.0, 5.0, 0.0 ]; + t.deepEqual( xbuf, expected, 'returns expected value' ); + + t.end(); +}); + +tape( 'the function supports a negative ending index', function test( t ) { + var searchElement; + var expected; + var actual; + var alpha; + var start; + var xbuf; + var end; + var x; + + xbuf = [ 0.0, 0.0, 0.0, 0.0 ]; + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'generic' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'generic' + }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( -1, { + 'dtype': 'generic' + }); + + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = [ 5.0, 5.0, 5.0, 0.0 ]; + t.deepEqual( xbuf, expected, 'returns expected value' ); + + t.end(); +}); + +tape( 'the function clamps out-of-bounds starting and ending indices', function test( t ) { + var searchElement; + var expected; + var actual; + var alpha; + var start; + var xbuf; + var end; + var x; + + xbuf = [ 0.0, 0.0, 0.0, 0.0 ]; + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'generic' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'generic' + }); + start = scalar2ndarray( -10, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 10, { + 'dtype': 'generic' + }); + + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = [ 5.0, 5.0, 5.0, 5.0 ]; + t.deepEqual( xbuf, expected, 'returns expected value' ); + + t.end(); +}); + +tape( 'if a resolved starting index is greater than or equal to a resolved ending index, the function returns the input ndarray unchanged', function test( t ) { + var searchElement; + var expected; + var actual; + var alpha; + var start; + var xbuf; + var end; + var x; + + xbuf = [ 0.0, 0.0, 0.0, 0.0 ]; + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'generic' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'generic' + }); + expected = [ 0.0, 0.0, 0.0, 0.0 ]; + + start = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + t.deepEqual( xbuf, expected, 'returns expected value' ); + + start = scalar2ndarray( 3, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 1, { + 'dtype': 'generic' + }); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + t.deepEqual( xbuf, expected, 'returns expected value' ); + + start = scalar2ndarray( 5, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + t.deepEqual( xbuf, expected, 'returns expected value' ); + + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( -10, { + 'dtype': 'generic' + }); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + t.deepEqual( xbuf, expected, 'returns expected value' ); + + t.end(); +}); + +tape( 'the function supports specifying a fill range for an input ndarray having a non-unit stride', function test( t ) { + var searchElement; + var expected; + var actual; + var alpha; + var start; + var xbuf; + var end; + var x; + + xbuf = [ 0.0, -2.0, 0.0, 4.0 ]; + x = vector( xbuf, 2, 2, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'generic' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'generic' + }); + start = scalar2ndarray( 1, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = [ 0.0, -2.0, 5.0, 4.0 ]; + t.deepEqual( xbuf, expected, 'returns expected value' ); + + t.end(); +}); + tape( 'if all elements are not equal to a provided search element, the function returns the input ndarray unchanged', function test( t ) { var searchElement; var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = [ 1.0, 2.0, 3.0, 4.0 ]; @@ -172,8 +473,14 @@ tape( 'if all elements are not equal to a provided search element, the function alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ 1.0, 2.0, 3.0, 4.0 ]; @@ -187,7 +494,9 @@ tape( 'if provided a search element equal to `NaN`, the function returns the inp var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = [ NaN, 1.0, NaN ]; @@ -198,8 +507,14 @@ tape( 'if provided a search element equal to `NaN`, the function returns the inp alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ NaN, 1.0, NaN ]; @@ -213,7 +528,9 @@ tape( 'the function does not replace `NaN` elements', function test( t ) { var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = [ NaN, 0.0, NaN ]; @@ -224,8 +541,14 @@ tape( 'the function does not replace `NaN` elements', function test( t ) { alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ NaN, 5.0, NaN ]; @@ -239,7 +562,9 @@ tape( 'the function considers `-0` and `+0` to be the same value', function test var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = [ -0.0, 1.0, 0.0, -0.0 ]; @@ -250,8 +575,14 @@ tape( 'the function considers `-0` and `+0` to be the same value', function test alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ 5.0, 1.0, 5.0, 5.0 ]; @@ -263,7 +594,7 @@ tape( 'the function considers `-0` and `+0` to be the same value', function test 'dtype': 'generic' }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [ 5.0, 1.0, 5.0, 5.0 ]; @@ -277,7 +608,9 @@ tape( 'the function returns the input ndarray unchanged when the input ndarray i var expected; var actual; var alpha; + var start; var xbuf; + var end; var x; xbuf = []; @@ -288,8 +621,14 @@ tape( 'the function returns the input ndarray unchanged when the input ndarray i alpha = scalar2ndarray( 5.0, { 'dtype': 'generic' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 0, { + 'dtype': 'generic' + }); - actual = gfillEqual( [ x, searchElement, alpha ] ); + actual = gfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = [];