diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/README.md b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/README.md index 5af933bd5fc8..e36731e98a1e 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/README.md +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/README.md @@ -54,8 +54,16 @@ var alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); -sfillNotEqual( [ x, searchElement, alpha ] ); -// x => [ 0.0, 5.0, 5.0, 0.0, 5.0, 5.0 ] +var start = scalar2ndarray( 0, { + 'dtype': 'generic' +}); + +var end = scalar2ndarray( 3, { + 'dtype': 'generic' +}); + +sfillNotEqual( [ x, searchElement, alpha, start, end ] ); +// x => [ 0.0, 5.0, 5.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 `true`, `NaN` elements are always replaced), 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 ) ); -sfillNotEqual( [ 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 ) ); + +sfillNotEqual( [ x, searchElement, alpha, start, end ] ); console.log( ndarray2array( x ) ); ``` diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/benchmark/benchmark.js index aa384ace23b3..e48b16597813 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/benchmark/benchmark.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/benchmark/benchmark.js @@ -48,11 +48,19 @@ 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, { + 'dtype': 'generic' + }); + end = scalar2ndarray( len, { + 'dtype': 'generic' + }); return benchmark; /** @@ -67,7 +75,7 @@ function createBenchmark( len ) { b.tic(); for ( i = 0; i < b.iterations; i++ ) { - out = sfillNotEqual( [ x, searchElement, alpha ] ); + out = sfillNotEqual( [ 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/sfill-not-equal/docs/repl.txt b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/repl.txt index bd2339de7b9a..8c22e2f68d0e 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/repl.txt +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-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 (i.e., as `NaN !== NaN` always evaluates to `true`, `NaN` elements @@ -20,6 +24,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 ------- @@ -28,11 +34,15 @@ Examples -------- - > 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 ] ) - [ 0.0, 5.0, 5.0, 0.0, 5.0, 5.0 ] + > var buf = [ 0.0, -2.0, 3.0, 0.0, 4.0, -6.0 ]; + > var x = new {{alias:@stdlib/ndarray/vector/float32}}( buf ); + > var opts = { 'dtype': 'float32' }; + > var v = {{alias:@stdlib/ndarray/from-scalar}}( 0.0, opts ); + > var alpha = {{alias:@stdlib/ndarray/from-scalar}}( 5.0, opts ); + > var st = {{alias:@stdlib/ndarray/from-scalar}}( 0, { 'dtype': 'generic' } ); + > var en = {{alias:@stdlib/ndarray/from-scalar}}( 3, { 'dtype': 'generic' } ); + > {{alias}}( [ x, v, alpha, st, en ] ) + [ 0.0, 5.0, 5.0, 0.0, 4.0, -6.0 ] See Also -------- diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/types/index.d.ts b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/types/index.d.ts index 5a51cfea6a57..ea3a75bec6f1 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/types/index.d.ts +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-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 (i.e., as `NaN !== NaN` always evaluates to `true`, `NaN` elements are always replaced), and `-0` and `+0` are considered the same. * @@ -52,10 +54,18 @@ import { float32ndarray, typedndarray } from '@stdlib/types/ndarray'; * 'dtype': 'float32' * }); * -* var out = sfillNotEqual( [ x, searchElement, alpha ] ); -* // returns [ 0.0, 5.0, 5.0, 0.0, 5.0, 5.0 ] +* var start = scalar2ndarray( 0, { +* 'dtype': 'generic' +* }); +* +* var end = scalar2ndarray( 3, { +* 'dtype': 'generic' +* }); +* +* var out = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); +* // returns [ 0.0, 5.0, 5.0, 0.0, 4.0, -6.0 ] */ -declare function sfillNotEqual( arrays: [ float32ndarray, typedndarray, typedndarray ] ): float32ndarray; +declare function sfillNotEqual( arrays: [ float32ndarray, typedndarray, typedndarray, typedndarray, typedndarray ] ): float32ndarray; // EXPORTS // diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/types/test.ts b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/types/test.ts index 86417a4f3f1a..aaa596bb694d 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/types/test.ts +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/docs/types/test.ts @@ -36,8 +36,14 @@ import sfillNotEqual = require( './index' ); const alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + const start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + const end = scalar2ndarray( 10, { + 'dtype': 'generic' + }); - sfillNotEqual( [ x, searchElement, alpha ] ); // $ExpectType float32ndarray + sfillNotEqual( [ 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 sfillNotEqual = require( './index' ); const alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + const start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + const end = scalar2ndarray( 10, { + 'dtype': 'generic' + }); sfillNotEqual(); // $ExpectError - sfillNotEqual( [ x, searchElement, alpha ], {} ); // $ExpectError + sfillNotEqual( [ x, searchElement, alpha, start, end ], {} ); // $ExpectError } diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/examples/index.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/examples/index.js index 8dadc1aef501..c42757c92027 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/examples/index.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-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 ) ); -sfillNotEqual( [ 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 ) ); + +sfillNotEqual( [ x, searchElement, alpha, start, end ] ); console.log( ndarray2array( x ) ); diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/lib/index.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/lib/index.js index e521f96a879c..e18673a1a1c2 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/lib/index.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/lib/index.js @@ -38,8 +38,16 @@ * 'dtype': 'float32' * }); * -* var out = sfillNotEqual( [ x, searchElement, alpha ] ); -* // returns [ 0.0, 5.0, 5.0, 0.0, 5.0, 5.0 ] +* var start = scalar2ndarray( 0, { +* 'dtype': 'generic' +* }); +* +* var end = scalar2ndarray( 3, { +* 'dtype': 'generic' +* }); +* +* var out = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); +* // returns [ 0.0, 5.0, 5.0, 0.0, 4.0, -6.0 ] */ // MODULES // diff --git a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/lib/main.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/lib/main.js index 4e9acf308ef9..02f55b24d5f4 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/lib/main.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-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-not-equal' ).ndarray; var ndarraylike2scalar = require( '@stdlib/ndarray/base/ndarraylike2scalar' ); +var strided = require( '@stdlib/blas/ext/base/sfill-not-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 `true`, `NaN` elements are always replaced), and `-0` and `+0` are considered the same. * @@ -60,18 +63,41 @@ var ndarraylike2scalar = require( '@stdlib/ndarray/base/ndarraylike2scalar' ); * 'dtype': 'float32' * }); * -* var out = sfillNotEqual( [ x, searchElement, alpha ] ); -* // returns [ 0.0, 5.0, 5.0, 0.0, 5.0, 5.0 ] +* var start = scalar2ndarray( 0, { +* 'dtype': 'generic' +* }); +* +* var end = scalar2ndarray( 3, { +* 'dtype': 'generic' +* }); +* +* var out = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); +* // returns [ 0.0, 5.0, 5.0, 0.0, 4.0, -6.0 ] */ function sfillNotEqual( 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-not-equal/test/test.js b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/test/test.js index 8e23d48c0b53..28726310d70e 100644 --- a/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/test/test.js +++ b/lib/node_modules/@stdlib/blas/ext/base/ndarray/sfill-not-equal/test/test.js @@ -59,7 +59,9 @@ tape( 'the function replaces elements not equal to a provided search element', f 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 not equal to a provided search element', f alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 6, { + 'dtype': 'generic' + }); - actual = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 0.0, 5.0, 5.0, 0.0, 5.0, 5.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 = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 0.0, -2.0, 5.0, 0.0, 5.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 = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 0.0, -2.0, 5.0, 0.0, 5.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 = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 0.0, -2.0, 3.0, 0.0, 5.0, 5.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, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); + x = vector( xbuf, 6, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + start = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 6, { + 'dtype': 'generic' + }); + + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 0.0, -2.0, 5.0, 0.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, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); + x = vector( xbuf, 6, 1, 0 ); + searchElement = scalar2ndarray( 0.0, { + 'dtype': 'float32' + }); + alpha = scalar2ndarray( 5.0, { + 'dtype': 'float32' + }); + start = scalar2ndarray( -4, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 6, { + 'dtype': 'generic' + }); + + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 0.0, -2.0, 5.0, 0.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, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); + x = vector( xbuf, 6, 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 = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 0.0, 5.0, 5.0, 0.0, 4.0, -6.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, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); + x = vector( xbuf, 6, 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 = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 0.0, 5.0, 5.0, 0.0, 4.0, -6.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, -2.0, 3.0, 0.0, 4.0, -6.0 ] ); + x = vector( xbuf, 6, 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 = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); + t.strictEqual( actual, x, 'returns expected value' ); + + expected = new Float32Array( [ 0.0, 5.0, 5.0, 0.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, -2.0, 3.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, -2.0, 3.0, 0.0 ] ); + + start = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 2, { + 'dtype': 'generic' + }); + actual = sfillNotEqual( [ 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 = sfillNotEqual( [ 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 = sfillNotEqual( [ 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 = sfillNotEqual( [ 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, 3.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 = sfillNotEqual( [ 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 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( [ 0.0, 0.0, 0.0, 0.0 ] ); @@ -174,8 +475,14 @@ tape( 'if all elements are equal to a provided search element, the function retu alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 4, { + 'dtype': 'generic' + }); - actual = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 0.0, 0.0, 0.0, 0.0 ] ); @@ -189,7 +496,9 @@ tape( 'if provided a search element equal to `NaN`, the function replaces all el 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 replaces all el alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 5.0, 5.0, 5.0 ] ); @@ -215,7 +530,9 @@ tape( 'the function replaces `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 replaces `NaN` elements', function test( t ) { alpha = scalar2ndarray( 5.0, { 'dtype': 'float32' }); + start = scalar2ndarray( 0, { + 'dtype': 'generic' + }); + end = scalar2ndarray( 3, { + 'dtype': 'generic' + }); - actual = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ 5.0, 0.0, 5.0 ] ); @@ -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 = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ -0.0, 5.0, 0.0, -0.0 ] ); @@ -265,7 +596,7 @@ tape( 'the function considers `-0` and `+0` to be the same value', function test 'dtype': 'float32' }); - actual = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [ -0.0, 5.0, 0.0, -0.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 = sfillNotEqual( [ x, searchElement, alpha ] ); + actual = sfillNotEqual( [ x, searchElement, alpha, start, end ] ); t.strictEqual( actual, x, 'returns expected value' ); expected = new Float32Array( [] );