From f4439b165ca4f39412e7ecc78f2d0f4ef93bf70a Mon Sep 17 00:00:00 2001 From: headlessNode Date: Thu, 27 Aug 2026 13:45:52 +0500 Subject: [PATCH] feat: add start and end parameter support to blas/ext/base/ndarray/sfill-equal --- .../ext/base/ndarray/sfill-equal/README.md | 29 +- .../sfill-equal/benchmark/benchmark.js | 10 +- .../base/ndarray/sfill-equal/docs/repl.txt | 12 +- .../ndarray/sfill-equal/docs/types/index.d.ts | 16 +- .../ndarray/sfill-equal/docs/types/test.ts | 16 +- .../ndarray/sfill-equal/examples/index.js | 14 +- .../ext/base/ndarray/sfill-equal/lib/index.js | 12 +- .../ext/base/ndarray/sfill-equal/lib/main.js | 34 +- .../ext/base/ndarray/sfill-equal/test/test.js | 359 +++++++++++++++++- 9 files changed, 472 insertions(+), 30 deletions(-) diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/README.md b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/README.md index ab780fbe0191..75685c092c2e 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/README.md +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/README.md @@ -54,8 +54,16 @@ var alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); -sfillEqual( [ 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' +}); + +sfillEqual( [ 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 and `-0` and `+0` are considered the same. @@ -98,7 +109,7 @@ var opts = { 'dtype': 'float32' }; -var x = discreteUniform( [ 10 ], 0, 3, opts ); +var x = discreteUniform( [ 20 ], 0, 3, opts ); console.log( ndarray2array( x ) ); var searchElement = scalar2ndarray( 1.0, opts ); @@ -107,7 +118,17 @@ console.log( 'Search Element: %d', ndarraylike2scalar( searchElement ) ); var alpha = scalar2ndarray( 5.0, opts ); console.log( 'Alpha: %d', ndarraylike2scalar( alpha ) ); -sfillEqual( [ x, searchElement, alpha ] ); +var start = scalar2ndarray( 5, { + 'dtype': 'generic' +}); +console.log( 'Start Index: %d', ndarraylike2scalar( start ) ); + +var end = scalar2ndarray( 15, { + 'dtype': 'generic' +}); +console.log( 'End Index: %d', ndarraylike2scalar( end ) ); + +sfillEqual( [ x, searchElement, alpha, start, end ] ); console.log( ndarray2array( x ) ); ``` diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/benchmark/benchmark.js index 3b17635fc03c..58a716bd31e4 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/benchmark/benchmark.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/benchmark/benchmark.js @@ -50,7 +50,9 @@ var options = { function createBenchmark( len ) { var searchElement; var alpha; + var start; var xbuf; + var end; var x; xbuf = uniform( len, -100.0, 100.0, options ); @@ -64,6 +66,12 @@ function createBenchmark( len ) { scalar2ndarray( 1.0, options ), scalar2ndarray( 0.0, options ) ]; + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( len, { + 'dtype': 'generic' + }); return benchmark; /** @@ -78,7 +86,7 @@ function createBenchmark( len ) { b.tic(); for ( i = 0; i < b.iterations; i++ ) { - out = sfillEqual( [ x, searchElement[i%2], alpha[i%2] ] ); + out = sfillEqual( [ x, searchElement[i%2], alpha[i%2], start, end ] ); if ( typeof out !== 'object' ) { b.fail( 'should return an ndarray' ); } diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/repl.txt b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/repl.txt index 0f5a35dfa1ea..141890410ed0 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/repl.txt +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/repl.txt @@ -7,6 +7,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 and `-0` and `+0` are considered the same. @@ -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 ------- @@ -30,8 +36,10 @@ > var x = new {{alias:@stdlib/ndarray/vector/float32}}( [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); > var v = {{alias:@stdlib/ndarray/from-scalar}}( 0.0, { 'dtype': 'float32' } ); > var alpha = {{alias:@stdlib/ndarray/from-scalar}}( 5.0, { 'dtype': 'float32' } ); - > {{alias}}( [ x, v, alpha ] ) - [ 5.0, -2.0, 3.0, 5.0, 4.0, -6.0 ] + > var st = {{alias:@stdlib/ndarray/from-scalar}}( 0, { 'dtype': 'generic' } ); + > var en = {{alias:@stdlib/ndarray/from-scalar}}( 2, { 'dtype': 'generic' } ); + > {{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/sfill-equal/docs/types/index.d.ts b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/types/index.d.ts index 87b0cc3d5795..4e7cfa8e4560 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/types/index.d.ts +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/types/index.d.ts @@ -32,6 +32,8 @@ import { float32ndarray, 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 and `-0` and `+0` are considered the same. * @@ -52,10 +54,18 @@ import { float32ndarray, typedndarray } from '@stdlib/types/ndarray'; * 'dtype': 'float32' * }); * -* var out = sfillEqual( [ 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 = sfillEqual( [ x, searchElement, alpha, start, end ] ); +* // returns [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] */ -declare function sfillEqual( arrays: [ float32ndarray, typedndarray, typedndarray ] ): float32ndarray; +declare function sfillEqual( arrays: [ float32ndarray, typedndarray, typedndarray, typedndarray, typedndarray ] ): float32ndarray; // EXPORTS // diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/types/test.ts b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/types/test.ts index edaedc2d06aa..23dfb64b5c9d 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/types/test.ts +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/docs/types/test.ts @@ -36,8 +36,14 @@ import sfillEqual = require( './index' ); const alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + const start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + const end = scalar2ndarray( 10, { + 'dtype': 'generic' + }); - sfillEqual( [ x, searchElement, alpha ] ); // $ExpectType float32ndarray + sfillEqual( [ x, searchElement, alpha, start, end ] ); // $ExpectType float32ndarray } // 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 sfillEqual = require( './index' ); const alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + const start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + const end = scalar2ndarray( 10, { + 'dtype': 'generic' + }); sfillEqual(); // $ExpectError - sfillEqual( [ x, searchElement, alpha ], {} ); // $ExpectError + sfillEqual( [ x, searchElement, alpha, start, end ], {} ); // $ExpectError } diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/examples/index.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/examples/index.js index 67a7a354fff2..b2b66531e126 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/examples/index.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/examples/index.js @@ -28,7 +28,7 @@ var opts = { 'dtype': 'float32' }; -var x = discreteUniform( [ 10 ], 0, 3, opts ); +var x = discreteUniform( [ 20 ], 0, 3, opts ); console.log( ndarray2array( x ) ); var searchElement = scalar2ndarray( 1.0, opts ); @@ -37,5 +37,15 @@ console.log( 'Search Element: %d', ndarraylike2scalar( searchElement ) ); var alpha = scalar2ndarray( 5.0, opts ); console.log( 'Alpha: %d', ndarraylike2scalar( alpha ) ); -sfillEqual( [ x, searchElement, alpha ] ); +var start = scalar2ndarray( 5, { + 'dtype': 'generic' +}); +console.log( 'Start Index: %d', ndarraylike2scalar( start ) ); + +var end = scalar2ndarray( 15, { + 'dtype': 'generic' +}); +console.log( 'End Index: %d', ndarraylike2scalar( end ) ); + +sfillEqual( [ x, searchElement, alpha, start, end ] ); console.log( ndarray2array( x ) ); diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/lib/index.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/lib/index.js index 3c434fc4b4f5..597b4a9e4b8f 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/lib/index.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/lib/index.js @@ -38,8 +38,16 @@ * 'dtype': 'float32' * }); * -* var out = sfillEqual( [ 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 = sfillEqual( [ 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/sfill-equal/lib/main.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/lib/main.js index 496675629323..9fcaa6bcb584 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/lib/main.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-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/sfill-equal' ).ndarray; var ndarraylike2scalar = require( '@stdlib/ndarray/base/ndarraylike2scalar' ); +var strided = require( '@stdlib/blas/ext/base/sfill-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 and `-0` and `+0` are considered the same. * @@ -60,18 +63,41 @@ var ndarraylike2scalar = require( '@stdlib/ndarray/base/ndarraylike2scalar' ); * 'dtype': 'float32' * }); * -* var out = sfillEqual( [ 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 = sfillEqual( [ x, searchElement, alpha, start, end ] ); +* // returns [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] */ function sfillEqual( 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/sfill-equal/test/test.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/test/test.js index 1e90cffd40d2..482520441959 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/test/test.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-equal/test/test.js @@ -59,7 +59,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 = new Float32Array( [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); @@ -70,8 +72,14 @@ tape( 'the function replaces elements equal to a provided search element', funct alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 6, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 5.0, -2.0, 3.0, 5.0, 4.0, -6.0 ] ); @@ -85,7 +93,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 = new Float32Array( [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); @@ -96,8 +106,14 @@ tape( 'the function supports an input ndarray having a non-unit stride', functio alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); @@ -111,7 +127,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 = new Float32Array( [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); @@ -122,8 +140,14 @@ tape( 'the function supports an input ndarray having a negative stride', functio alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 5.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); @@ -137,7 +161,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 = new Float32Array( [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); @@ -148,8 +174,14 @@ tape( 'the function supports an input ndarray having a non-zero offset', functio alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 0.0, -2.0, 3.0, 5.0, 4.0, -6.0 ] ); @@ -158,12 +190,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 = new Float32Array( [ 0.0, 0.0, 0.0, 0.0 ] ); + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + start = scalar2ndarray( 1, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); + + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 0.0, 5.0, 5.0, 5.0 ] ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, '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 = new Float32Array( [ 0.0, 0.0, 0.0, 0.0 ] ); + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + start = scalar2ndarray( -3, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); + + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 0.0, 5.0, 5.0, 5.0 ] ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, '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 = new Float32Array( [ 0.0, 0.0, 0.0, 0.0 ] ); + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); + + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 5.0, 5.0, 5.0, 0.0 ] ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, '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 = new Float32Array( [ 0.0, 0.0, 0.0, 0.0 ] ); + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( -1, { + 'dtype': 'generic' + }); + + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 5.0, 5.0, 5.0, 0.0 ] ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, '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 = new Float32Array( [ 0.0, 0.0, 0.0, 0.0 ] ); + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + start = scalar2ndarray( -10, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 10, { + 'dtype': 'generic' + }); + + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 5.0, 5.0, 5.0, 5.0 ] ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, '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 = new Float32Array( [ 0.0, 0.0, 0.0, 0.0 ] ); + x = vector( xbuf, 4, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + expected = new Float32Array( [ 0.0, 0.0, 0.0, 0.0 ] ); + + start = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, 'returns expected value' ); + + start = scalar2ndarray( 3, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 1, { + 'dtype': 'generic' + }); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, 'returns expected value' ); + + start = scalar2ndarray( 5, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, 'returns expected value' ); + + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( -10, { + 'dtype': 'generic' + }); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, '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 = new Float32Array( [ 0.0, -2.0, 0.0, 4.0 ] ); + x = vector( xbuf, 2, 2, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + start = scalar2ndarray( 1, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 0.0, -2.0, 5.0, 4.0 ] ); + t.strictEqual( isSameFloat32Array( getData( actual ), expected ), true, '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 = new Float32Array( [ 1.0, 2.0, 3.0, 4.0 ] ); @@ -174,8 +475,14 @@ tape( 'if all elements are not equal to a provided search element, the function alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 1.0, 2.0, 3.0, 4.0 ] ); @@ -189,7 +496,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 = new Float32Array( [ NaN, 1.0, NaN ] ); @@ -200,8 +509,14 @@ tape( 'if provided a search element equal to `NaN`, the function returns the inp alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ NaN, 1.0, NaN ] ); @@ -215,7 +530,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 = new Float32Array( [ NaN, 0.0, NaN ] ); @@ -226,8 +543,14 @@ tape( 'the function does not replace `NaN` elements', function test( t ) { alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ NaN, 5.0, NaN ] ); @@ -241,7 +564,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 = new Float32Array( [ -0.0, 1.0, 0.0, -0.0 ] ); @@ -252,8 +577,14 @@ tape( 'the function considers `-0` and `+0` to be the same value', function test alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 5.0, 1.0, 5.0, 5.0 ] ); @@ -265,7 +596,7 @@ tape( 'the function considers `-0` and `+0` to be the same value', function test 'dtype': 'float32' }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 5.0, 1.0, 5.0, 5.0 ] ); @@ -279,7 +610,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 = new Float32Array( [] ); @@ -290,8 +623,14 @@ tape( 'the function returns the input ndarray unchanged when the input ndarray i alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 0, { + 'dtype': 'generic' + }); - actual = sfillEqual( [ x, searchElement, alpha ] ); + actual = sfillEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [] );