From 3c82fe7b6c0f9fd6ef02c86d6e2024d708ac8c14 Mon Sep 17 00:00:00 2001 From: Athan Reines Date: Fri, 1 Dec 2023 02:19:15 -0800 Subject: [PATCH] refactor: update implementation in accordance with current project conventions Ref: https://github.com/stdlib-js/stdlib/issues/788 --- .../@stdlib/blas/base/cswap/README.md | 34 +-- .../blas/base/cswap/benchmark/benchmark.js | 25 +- .../base/cswap/benchmark/benchmark.native.js | 21 +- .../base/cswap/benchmark/benchmark.ndarray.js | 25 +- .../benchmark/benchmark.ndarray.native.js | 21 +- .../@stdlib/blas/base/cswap/docs/repl.txt | 6 +- .../blas/base/cswap/examples/c/example.c | 6 +- .../@stdlib/blas/base/cswap/examples/index.js | 19 +- .../@stdlib/blas/base/cswap/include.gypi | 2 +- .../@stdlib/blas/base/cswap/lib/cswap.js | 6 +- .../blas/base/cswap/lib/cswap.native.js | 6 +- .../@stdlib/blas/base/cswap/lib/ndarray.js | 6 +- .../blas/base/cswap/lib/ndarray.native.js | 18 +- .../@stdlib/blas/base/cswap/manifest.json | 262 ++++++++++-------- .../@stdlib/blas/base/cswap/src/addon.c | 45 +++ .../@stdlib/blas/base/cswap/src/addon.cpp | 151 ---------- .../blas/base/cswap/test/test.cswap.js | 47 ++-- .../blas/base/cswap/test/test.cswap.native.js | 47 ++-- .../blas/base/cswap/test/test.ndarray.js | 48 ++-- .../base/cswap/test/test.ndarray.native.js | 48 ++-- 20 files changed, 384 insertions(+), 459 deletions(-) create mode 100644 lib/node_modules/@stdlib/blas/base/cswap/src/addon.c delete mode 100644 lib/node_modules/@stdlib/blas/base/cswap/src/addon.cpp diff --git a/lib/node_modules/@stdlib/blas/base/cswap/README.md b/lib/node_modules/@stdlib/blas/base/cswap/README.md index d82e8714634..d6e47962ca2 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/README.md +++ b/lib/node_modules/@stdlib/blas/base/cswap/README.md @@ -66,25 +66,22 @@ im = imagf( z ); The function has the following parameters: - **N**: number of indexed elements. -- **x**: input [`Complex64Array`][@stdlib/array/complex64]. +- **x**: first input [`Complex64Array`][@stdlib/array/complex64]. - **strideX**: index increment for `x`. -- **y**: destination [`Complex64Array`][@stdlib/array/complex64]. +- **y**: second input [`Complex64Array`][@stdlib/array/complex64]. - **strideY**: index increment for `y`. -The `N` and `stride` parameters determine how values from `x` are interchanged with values from `y`. For example, to interchange in reverse order every other value in `x` into the first `N` elements of `y`, +The `N` and stride parameters determine how values from `x` are interchanged with values from `y`. For example, to interchange in reverse order every other value in `x` into the first `N` elements of `y`, ```javascript var Complex64Array = require( '@stdlib/array/complex64' ); -var floor = require( '@stdlib/math/base/special/floor' ); var realf = require( '@stdlib/complex/realf' ); var imagf = require( '@stdlib/complex/imagf' ); var x = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] ); var y = new Complex64Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] ); -var N = floor( x.length / 2 ); - -cswap( N, x, -2, y, 1 ); +cswap( 2, x, -2, y, 1 ); var z = y.get( 0 ); // returns @@ -182,7 +179,7 @@ The function has the following additional parameters: - **offsetX**: starting index for `x`. - **offsetY**: starting index for `y`. -While [`typed array`][mdn-typed-array] views mandate a view offset based on the underlying `buffer`, the `offsetX` and `offsetY` parameters support indexing semantics based on starting indices. For example, to interchange every other value in `x` starting from the second value into the last `N` elements in `y` where `x[i] = y[n]`, `x[i+2] = y[n-1]`,..., +While [`typed array`][mdn-typed-array] views mandate a view offset based on the underlying `buffer`, the offset parameters support indexing semantics based on starting indices. For example, to interchange every other value in `x` starting from the second value into the last `N` elements in `y` where `x[i] = y[n]`, `x[i+2] = y[n-1]`,..., ```javascript var Complex64Array = require( '@stdlib/array/complex64' ); @@ -236,24 +233,21 @@ im = imagf( z ); ```javascript var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ); -var Complex64Array = require( '@stdlib/array/complex64' ); +var filledarrayBy = require( '@stdlib/array/filled-by' ); +var Complex64 = require( '@stdlib/complex/float32' ); var cswap = require( '@stdlib/blas/base/cswap' ); -var re = discreteUniform.factory( 0, 10 ); -var im = discreteUniform.factory( -5, 5 ); - -var x = new Complex64Array( 10 ); -var y = new Complex64Array( 10 ); - -var i; -for ( i = 0; i < x.length; i++ ) { - x.set( [ re(), im() ], i ); - y.set( [ re(), im() ], i ); +function rand() { + return new Complex64( discreteUniform( 0, 10 ), discreteUniform( -5, 5 ) ); } + +var x = filledarrayBy( 10, 'complex64', rand ); console.log( x.get( 0 ).toString() ); + +var y = filledarrayBy( 10, 'complex64', rand ); console.log( y.get( 0 ).toString() ); -// Swap elements in `x` and `y` starting from the end of `y`: +// Swap elements in `x` into `y` starting from the end of `y`: cswap( x.length, x, 1, y, -1 ); console.log( x.get( x.length-1 ).toString() ); console.log( y.get( y.length-1 ).toString() ); diff --git a/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.js index 072763b3295..8ad070b6b61 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.js @@ -21,15 +21,21 @@ // MODULES // var bench = require( '@stdlib/bench' ); -var randu = require( '@stdlib/random/base/randu' ); +var uniform = require( '@stdlib/random/base/uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var pow = require( '@stdlib/math/base/special/pow' ); var Complex64Array = require( '@stdlib/array/complex64' ); -var Float32Array = require( '@stdlib/array/float32' ); +var reinterpret = require( '@stdlib/strided/base/reinterpret-complex64' ); var pkg = require( './../package.json' ).name; var cswap = require( './../lib/cswap.js' ); +// VARIABLES // + +var rand = uniform( -100.0, 100.0 ); + + // FUNCTIONS // /** @@ -43,14 +49,13 @@ function createBenchmark( len ) { var viewY; var x; var y; - var i; - x = new Complex64Array( len ); + x = filledarrayBy( len*2, 'float32', rand ); + x = new Complex64Array( x.buffer ); + y = new Complex64Array( len ); - for ( i = 0; i < len; i++ ) { - x.set( [ (randu()*10000.0)-5000.0, (randu()*10000.0)-5000.0 ], i ); - } - viewY = new Float32Array( y.buffer, y.byteOffset, y.length*2 ); + viewY = reinterpret( y, 0 ); + return benchmark; /** @@ -62,8 +67,8 @@ function createBenchmark( len ) { function benchmark( b ) { var i; - for ( i = 0; i < len; i++ ) { - y.set( [ 0.0, 0.0 ], i ); + for ( i = 0; i < len*2; i++ ) { + viewY[ i ] = 0.0; } b.tic(); for ( i = 0; i < b.iterations; i++ ) { diff --git a/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.native.js b/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.native.js index e230622f880..69b1fc49e15 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.native.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.native.js @@ -22,11 +22,12 @@ var resolve = require( 'path' ).resolve; var bench = require( '@stdlib/bench' ); -var randu = require( '@stdlib/random/base/randu' ); +var uniform = require( '@stdlib/random/base/uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var pow = require( '@stdlib/math/base/special/pow' ); var Complex64Array = require( '@stdlib/array/complex64' ); -var Float32Array = require( '@stdlib/array/float32' ); +var reinterpret = require( '@stdlib/strided/base/reinterpret-complex64' ); var tryRequire = require( '@stdlib/utils/try-require' ); var pkg = require( './../package.json' ).name; @@ -37,6 +38,7 @@ var cswap = tryRequire( resolve( __dirname, './../lib/cswap.native.js' ) ); var opts = { 'skip': ( cswap instanceof Error ) }; +var rand = uniform( -100.0, 100.0 ); // FUNCTIONS // @@ -52,14 +54,13 @@ function createBenchmark( len ) { var viewY; var x; var y; - var i; - x = new Complex64Array( len ); + x = filledarrayBy( len*2, 'float32', rand ); + x = new Complex64Array( x.buffer ); + y = new Complex64Array( len ); - for ( i = 0; i < len; i++ ) { - x.set( [ (randu()*10000.0)-5000.0, (randu()*10000.0)-5000.0 ], i ); - } - viewY = new Float32Array( y.buffer, y.byteOffset, y.length*2 ); + viewY = reinterpret( y, 0 ); + return benchmark; /** @@ -71,8 +72,8 @@ function createBenchmark( len ) { function benchmark( b ) { var i; - for ( i = 0; i < len; i++ ) { - y.set( [ 0.0, 0.0 ], i ); + for ( i = 0; i < len*2; i++ ) { + viewY[ i ] = 0.0; } b.tic(); for ( i = 0; i < b.iterations; i++ ) { diff --git a/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.ndarray.js b/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.ndarray.js index fa4be582da9..a83844d14d3 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.ndarray.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.ndarray.js @@ -21,15 +21,21 @@ // MODULES // var bench = require( '@stdlib/bench' ); -var randu = require( '@stdlib/random/base/randu' ); +var uniform = require( '@stdlib/random/base/uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var pow = require( '@stdlib/math/base/special/pow' ); var Complex64Array = require( '@stdlib/array/complex64' ); -var Float32Array = require( '@stdlib/array/float32' ); +var reinterpret = require( '@stdlib/strided/base/reinterpret-complex64' ); var pkg = require( './../package.json' ).name; var cswap = require( './../lib/ndarray.js' ); +// VARIABLES // + +var rand = uniform( -100.0, 100.0 ); + + // FUNCTIONS // /** @@ -43,14 +49,13 @@ function createBenchmark( len ) { var viewY; var x; var y; - var i; - x = new Complex64Array( len ); + x = filledarrayBy( len*2, 'float32', rand ); + x = new Complex64Array( x.buffer ); + y = new Complex64Array( len ); - for ( i = 0; i < len; i++ ) { - x.set( [ (randu()*10000.0)-5000.0, (randu()*10000.0)-5000.0 ], i ); - } - viewY = new Float32Array( y.buffer, y.byteOffset, y.length*2 ); + viewY = reinterpret( y, 0 ); + return benchmark; /** @@ -62,8 +67,8 @@ function createBenchmark( len ) { function benchmark( b ) { var i; - for ( i = 0; i < len; i++ ) { - y.set( [ 0.0, 0.0 ], i ); + for ( i = 0; i < len*2; i++ ) { + viewY[ i ] = 0.0; } b.tic(); for ( i = 0; i < b.iterations; i++ ) { diff --git a/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.ndarray.native.js b/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.ndarray.native.js index 9f8ed9a073d..c8e86efa083 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.ndarray.native.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/benchmark/benchmark.ndarray.native.js @@ -22,11 +22,12 @@ var resolve = require( 'path' ).resolve; var bench = require( '@stdlib/bench' ); -var randu = require( '@stdlib/random/base/randu' ); +var uniform = require( '@stdlib/random/base/uniform' ).factory; +var filledarrayBy = require( '@stdlib/array/filled-by' ); var isnan = require( '@stdlib/math/base/assert/is-nan' ); var pow = require( '@stdlib/math/base/special/pow' ); var Complex64Array = require( '@stdlib/array/complex64' ); -var Float32Array = require( '@stdlib/array/float32' ); +var reinterpret = require( '@stdlib/strided/base/reinterpret-complex64' ); var tryRequire = require( '@stdlib/utils/try-require' ); var pkg = require( './../package.json' ).name; @@ -37,6 +38,7 @@ var cswap = tryRequire( resolve( __dirname, './../lib/ndarray.native.js' ) ); var opts = { 'skip': ( cswap instanceof Error ) }; +var rand = uniform( -100.0, 100.0 ); // FUNCTIONS // @@ -52,14 +54,13 @@ function createBenchmark( len ) { var viewY; var x; var y; - var i; - x = new Complex64Array( len ); + x = filledarrayBy( len*2, 'float32', rand ); + x = new Complex64Array( x.buffer ); + y = new Complex64Array( len ); - for ( i = 0; i < len; i++ ) { - x.set( [ (randu()*10000.0)-5000.0, (randu()*10000.0)-5000.0 ], i ); - } - viewY = new Float32Array( y.buffer, y.byteOffset, y.length*2 ); + viewY = reinterpret( y, 0 ); + return benchmark; /** @@ -71,8 +72,8 @@ function createBenchmark( len ) { function benchmark( b ) { var i; - for ( i = 0; i < len; i++ ) { - y.set( [ 0.0, 0.0 ], i ); + for ( i = 0; i < len*2; i++ ) { + viewY[ i ] = 0.0; } b.tic(); for ( i = 0; i < b.iterations; i++ ) { diff --git a/lib/node_modules/@stdlib/blas/base/cswap/docs/repl.txt b/lib/node_modules/@stdlib/blas/base/cswap/docs/repl.txt index 68589b6bc02..c7294c40269 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/docs/repl.txt +++ b/lib/node_modules/@stdlib/blas/base/cswap/docs/repl.txt @@ -2,8 +2,8 @@ {{alias}}( N, x, strideX, y, strideY ) Interchanges two complex single-precision floating-point vectors. - The `N` and `stride` parameters determine how values from `x` are swapped - with values from `y`. + The `N` and stride parameters determine how values from `x` are swapped with + values from `y`. Indexing is relative to the first index. To introduce an offset, use typed array views. @@ -89,7 +89,7 @@ alternative indexing semantics. While typed array views mandate a view offset based on the underlying - buffer, the `offset` parameters support indexing semantics based on starting + buffer, the offset parameters support indexing semantics based on starting indices. Parameters diff --git a/lib/node_modules/@stdlib/blas/base/cswap/examples/c/example.c b/lib/node_modules/@stdlib/blas/base/cswap/examples/c/example.c index c06f56c887d..0f17ba87c58 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/examples/c/example.c +++ b/lib/node_modules/@stdlib/blas/base/cswap/examples/c/example.c @@ -25,11 +25,11 @@ int main( void ) { float y[] = { 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 }; // Specify the number of elements: - int N = 4; + const int N = 4; // Specify stride lengths: - int strideX = 1; - int strideY = -1; + const int strideX = 1; + const int strideY = -1; // Copy elements: c_cswap( N, (void *)x, strideX, (void *)y, strideY ); diff --git a/lib/node_modules/@stdlib/blas/base/cswap/examples/index.js b/lib/node_modules/@stdlib/blas/base/cswap/examples/index.js index 4637de5cd01..982d368dbdd 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/examples/index.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/examples/index.js @@ -19,21 +19,18 @@ 'use strict'; var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ); -var Complex64Array = require( '@stdlib/array/complex64' ); +var filledarrayBy = require( '@stdlib/array/filled-by' ); +var Complex64 = require( '@stdlib/complex/float32' ); var cswap = require( './../lib' ); -var re = discreteUniform.factory( 0, 10 ); -var im = discreteUniform.factory( -5, 5 ); - -var x = new Complex64Array( 10 ); -var y = new Complex64Array( 10 ); - -var i; -for ( i = 0; i < x.length; i++ ) { - x.set( [ re(), im() ], i ); - y.set( [ re(), im() ], i ); +function rand() { + return new Complex64( discreteUniform( 0, 10 ), discreteUniform( -5, 5 ) ); } + +var x = filledarrayBy( 10, 'complex64', rand ); console.log( x.get( 0 ).toString() ); + +var y = filledarrayBy( 10, 'complex64', rand ); console.log( y.get( 0 ).toString() ); // Swap elements in `x` into `y` starting from the end of `y`: diff --git a/lib/node_modules/@stdlib/blas/base/cswap/include.gypi b/lib/node_modules/@stdlib/blas/base/cswap/include.gypi index 9a3ec86b916..be025fb6b87 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/include.gypi +++ b/lib/node_modules/@stdlib/blas/base/cswap/include.gypi @@ -52,7 +52,7 @@ # Source files: 'src_files': [ - '<(src_dir)/addon.cpp', + '<(src_dir)/addon.c', ' + +/** +* Receives JavaScript callback invocation data. +* +* @private +* @param env environment under which the function is invoked +* @param info callback data +* @return Node-API value +*/ +static napi_value addon( napi_env env, napi_callback_info info ) { + STDLIB_NAPI_ARGV( env, info, argv, argc, 5 ); + STDLIB_NAPI_ARGV_INT64( env, N, argv, 0 ); + STDLIB_NAPI_ARGV_INT64( env, strideX, argv, 2 ); + STDLIB_NAPI_ARGV_INT64( env, strideY, argv, 4 ); + STDLIB_NAPI_ARGV_STRIDED_COMPLEX64ARRAY( env, X, N, strideX, argv, 1 ); + STDLIB_NAPI_ARGV_STRIDED_COMPLEX64ARRAY( env, Y, N, strideY, argv, 3 ); + c_cswap( N, (void *)X, strideX, (void *)Y, strideY ); + return NULL; +} + +STDLIB_NAPI_MODULE_EXPORT_FCN( addon ) diff --git a/lib/node_modules/@stdlib/blas/base/cswap/src/addon.cpp b/lib/node_modules/@stdlib/blas/base/cswap/src/addon.cpp deleted file mode 100644 index 179692db4b2..00000000000 --- a/lib/node_modules/@stdlib/blas/base/cswap/src/addon.cpp +++ /dev/null @@ -1,151 +0,0 @@ -/** -* @license Apache-2.0 -* -* Copyright (c) 2020 The Stdlib Authors. -* -* Licensed under the Apache License, Version 2.0 (the "License"); -* you may not use this file except in compliance with the License. -* You may obtain a copy of the License at -* -* http://www.apache.org/licenses/LICENSE-2.0 -* -* Unless required by applicable law or agreed to in writing, software -* distributed under the License is distributed on an "AS IS" BASIS, -* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -* See the License for the specific language governing permissions and -* limitations under the License. -*/ - -#include "stdlib/blas/base/cswap.h" -#include -#include -#include -#include -#include - -/** -* Add-on namespace. -*/ -namespace stdlib_blas_base_cswap { - - /** - * Interchanges two complex single-precision floating-point vectors. - * - * ## Notes - * - * - When called from JavaScript, the function expects five arguments: - * - * - `N`: number of indexed elements - * - `X`: first input array - * - `strideX`: `X` stride length - * - `Y`: second input array - * - `strideY`: `Y` stride length - */ - napi_value node_cswap( napi_env env, napi_callback_info info ) { - napi_status status; - - size_t argc = 5; - napi_value argv[ 5 ]; - status = napi_get_cb_info( env, info, &argc, argv, nullptr, nullptr ); - assert( status == napi_ok ); - - if ( argc < 5 ) { - napi_throw_error( env, nullptr, "invalid invocation. Must provide 5 arguments." ); - return nullptr; - } - - napi_valuetype vtype0; - status = napi_typeof( env, argv[ 0 ], &vtype0 ); - assert( status == napi_ok ); - if ( vtype0 != napi_number ) { - napi_throw_type_error( env, nullptr, "invalid argument. First argument must be a number." ); - return nullptr; - } - - bool res1; - status = napi_is_typedarray( env, argv[ 1 ], &res1 ); - assert( status == napi_ok ); - if ( res1 == false ) { - napi_throw_type_error( env, nullptr, "invalid argument. Second argument must be a Float32Array." ); - return nullptr; - } - - napi_valuetype vtype2; - status = napi_typeof( env, argv[ 2 ], &vtype2 ); - assert( status == napi_ok ); - if ( vtype2 != napi_number ) { - napi_throw_type_error( env, nullptr, "invalid argument. Third argument must be a number." ); - return nullptr; - } - - bool res3; - status = napi_is_typedarray( env, argv[ 3 ], &res3 ); - assert( status == napi_ok ); - if ( res3 == false ) { - napi_throw_type_error( env, nullptr, "invalid argument. Fourth argument must be a Float32Array." ); - return nullptr; - } - - napi_valuetype vtype4; - status = napi_typeof( env, argv[ 4 ], &vtype4 ); - assert( status == napi_ok ); - if ( vtype4 != napi_number ) { - napi_throw_type_error( env, nullptr, "invalid argument. Fifth argument must be a number." ); - return nullptr; - } - - int64_t N; - status = napi_get_value_int64( env, argv[ 0 ], &N ); - assert( status == napi_ok ); - - int64_t strideX; - status = napi_get_value_int64( env, argv[ 2 ], &strideX ); - assert( status == napi_ok ); - - int64_t strideY; - status = napi_get_value_int64( env, argv[ 4 ], &strideY ); - assert( status == napi_ok ); - - napi_typedarray_type vtype1; - size_t xlen; - void *X; - status = napi_get_typedarray_info( env, argv[ 1 ], &vtype1, &xlen, &X, nullptr, nullptr ); - assert( status == napi_ok ); - if ( vtype1 != napi_float32_array ) { - napi_throw_type_error( env, nullptr, "invalid argument. Second argument must be a Float32Array." ); - return nullptr; - } - if ( 2*(N-1)*llabs(strideX) >= (int64_t)xlen ) { - napi_throw_range_error( env, nullptr, "invalid argument. Second argument has insufficient elements based on the associated stride and the number of indexed elements." ); - return nullptr; - } - - napi_typedarray_type vtype3; - size_t ylen; - void *Y; - status = napi_get_typedarray_info( env, argv[ 3 ], &vtype3, &ylen, &Y, nullptr, nullptr ); - assert( status == napi_ok ); - if ( vtype3 != napi_float32_array ) { - napi_throw_type_error( env, nullptr, "invalid argument. Fourth argument must be a Float32Array." ); - return nullptr; - } - if ( 2*(N-1)*llabs(strideY) >= (int64_t)ylen ) { - napi_throw_range_error( env, nullptr, "invalid argument. Fourth argument has insufficient elements based on the associated stride and the number of indexed elements." ); - return nullptr; - } - - c_cswap( N, X, strideX, Y, strideY ); - - return nullptr; - } - - napi_value Init( napi_env env, napi_value exports ) { - napi_status status; - napi_value fcn; - status = napi_create_function( env, "exports", NAPI_AUTO_LENGTH, node_cswap, NULL, &fcn ); - assert( status == napi_ok ); - return fcn; - } - - NAPI_MODULE( NODE_GYP_MODULE_NAME, Init ) -} // end namespace stdlib_blas_base_cswap diff --git a/lib/node_modules/@stdlib/blas/base/cswap/test/test.cswap.js b/lib/node_modules/@stdlib/blas/base/cswap/test/test.cswap.js index e87c673d2a6..9c473757956 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/test/test.cswap.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/test/test.cswap.js @@ -21,7 +21,6 @@ // MODULES // var tape = require( 'tape' ); -var floor = require( '@stdlib/math/base/special/floor' ); var Float32Array = require( '@stdlib/array/float32' ); var Complex64Array = require( '@stdlib/array/complex64' ); var scopy = require( '@stdlib/blas/base/scopy' ); @@ -37,7 +36,7 @@ tape( 'main export is a function', function test( t ) { }); tape( 'the function has an arity of 5', function test( t ) { - t.strictEqual( cswap.length, 5, 'arity of 5' ); + t.strictEqual( cswap.length, 5, 'returns expected value' ); t.end(); }); @@ -60,8 +59,8 @@ tape( 'the function swaps elements in `x` and `y`', function test( t ) { cswap( x.length, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.notEqual( y, x, 'different references' ); t.end(); @@ -106,8 +105,8 @@ tape( 'the function supports an `x` stride', function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 5.0, 6.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -150,8 +149,8 @@ tape( 'the function supports a `y` stride', function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 5.0, 6.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 0.0, 0.0, 3.0, 4.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -165,7 +164,7 @@ tape( 'the function returns a reference to the destination array', function test out = cswap( x.length, x, 1, y, 1 ); - t.strictEqual( out, y, 'same reference' ); + t.strictEqual( out, y, 'returns expected value' ); t.end(); }); @@ -187,12 +186,12 @@ tape( 'if provided an `N` parameter less than or equal to `0`, the function retu ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] ); cswap( -1, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'returns `x` unchanged' ); - t.deepEqual( viewY, ye, 'returns `y` unchanged' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); cswap( 0, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'returns `x` unchanged' ); - t.deepEqual( viewY, ye, 'returns `y` unchanged' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -236,8 +235,8 @@ tape( 'the function supports negative strides', function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 5.0, 6.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -280,8 +279,8 @@ tape( 'the function supports complex access patterns', function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 5.0, 6.0, 1.0, 2.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -322,7 +321,7 @@ tape( 'the function supports view offsets', function test( t ) { x1 = new Complex64Array( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); // begin at 2nd element y1 = new Complex64Array( y0.buffer, y0.BYTES_PER_ELEMENT*2 ); // begin at the 3rd element - N = floor( x0.length / 2 ); + N = 2; viewX = new Float32Array( x0.buffer ); viewY = new Float32Array( y0.buffer ); @@ -332,8 +331,8 @@ tape( 'the function supports view offsets', function test( t ) { xe = new Float32Array( [ 1.0, 2.0, 0.0, 0.0, 5.0, 6.0, 0.0, 0.0 ] ); ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 7.0, 8.0, 3.0, 4.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -360,8 +359,8 @@ tape( 'if both strides are equal to `1`, the function efficiently swaps elements cswap( x.length, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); x = new Complex64Array( 120 ); y = new Complex64Array( x.length ); @@ -377,8 +376,8 @@ tape( 'if both strides are equal to `1`, the function efficiently swaps elements cswap( x.length, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); diff --git a/lib/node_modules/@stdlib/blas/base/cswap/test/test.cswap.native.js b/lib/node_modules/@stdlib/blas/base/cswap/test/test.cswap.native.js index e440375132d..1242b22159d 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/test/test.cswap.native.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/test/test.cswap.native.js @@ -22,7 +22,6 @@ var resolve = require( 'path' ).resolve; var tape = require( 'tape' ); -var floor = require( '@stdlib/math/base/special/floor' ); var Float32Array = require( '@stdlib/array/float32' ); var Complex64Array = require( '@stdlib/array/complex64' ); var scopy = require( '@stdlib/blas/base/scopy' ); @@ -46,7 +45,7 @@ tape( 'main export is a function', opts, function test( t ) { }); tape( 'the function has an arity of 5', opts, function test( t ) { - t.strictEqual( cswap.length, 5, 'arity of 5' ); + t.strictEqual( cswap.length, 5, 'returns expected value' ); t.end(); }); @@ -69,8 +68,8 @@ tape( 'the function swaps elements in `x` and `y`', opts, function test( t ) { cswap( x.length, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.notEqual( y, x, 'different references' ); t.end(); @@ -115,8 +114,8 @@ tape( 'the function supports an `x` stride', opts, function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 5.0, 6.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -159,8 +158,8 @@ tape( 'the function supports a `y` stride', opts, function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 5.0, 6.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 0.0, 0.0, 3.0, 4.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -174,7 +173,7 @@ tape( 'the function returns a reference to the destination array', opts, functio out = cswap( x.length, x, 1, y, 1 ); - t.strictEqual( out, y, 'same reference' ); + t.strictEqual( out, y, 'returns expected value' ); t.end(); }); @@ -196,12 +195,12 @@ tape( 'if provided an `N` parameter less than or equal to `0`, the function retu ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] ); cswap( -1, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'returns `x` unchanged' ); - t.deepEqual( viewY, ye, 'returns `y` unchanged' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); cswap( 0, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'returns `x` unchanged' ); - t.deepEqual( viewY, ye, 'returns `y` unchanged' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -245,8 +244,8 @@ tape( 'the function supports negative strides', opts, function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 5.0, 6.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -289,8 +288,8 @@ tape( 'the function supports complex access patterns', opts, function test( t ) xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 5.0, 6.0, 1.0, 2.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -331,7 +330,7 @@ tape( 'the function supports view offsets', opts, function test( t ) { x1 = new Complex64Array( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); // begin at 2nd element y1 = new Complex64Array( y0.buffer, y0.BYTES_PER_ELEMENT*2 ); // begin at the 3rd element - N = floor( x0.length / 2 ); + N = 2; viewX = new Float32Array( x0.buffer ); viewY = new Float32Array( y0.buffer ); @@ -341,8 +340,8 @@ tape( 'the function supports view offsets', opts, function test( t ) { xe = new Float32Array( [ 1.0, 2.0, 0.0, 0.0, 5.0, 6.0, 0.0, 0.0 ] ); ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 7.0, 8.0, 3.0, 4.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -369,8 +368,8 @@ tape( 'if both strides are equal to `1`, the function efficiently swaps elements cswap( x.length, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); x = new Complex64Array( 120 ); y = new Complex64Array( x.length ); @@ -386,8 +385,8 @@ tape( 'if both strides are equal to `1`, the function efficiently swaps elements cswap( x.length, x, 1, y, 1 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); diff --git a/lib/node_modules/@stdlib/blas/base/cswap/test/test.ndarray.js b/lib/node_modules/@stdlib/blas/base/cswap/test/test.ndarray.js index 00ce38e0062..98567dd7556 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/test/test.ndarray.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/test/test.ndarray.js @@ -36,7 +36,7 @@ tape( 'main export is a function', function test( t ) { }); tape( 'the function has an arity of 7', function test( t ) { - t.strictEqual( cswap.length, 7, 'arity of 7' ); + t.strictEqual( cswap.length, 7, 'returns expected value' ); t.end(); }); @@ -59,8 +59,8 @@ tape( 'the function swaps elements in `x` and `y`', function test( t ) { cswap( x.length, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.notEqual( y, x, 'different references' ); t.end(); @@ -105,8 +105,8 @@ tape( 'the function supports an `x` stride', function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 5.0, 6.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -149,8 +149,8 @@ tape( 'the function supports an `x` offset', function test( t ) { xe = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 0.0, 0.0, 0.0, 0.0 ] ); ye = new Float32Array( [ 5.0, 6.0, 7.0, 8.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -193,8 +193,8 @@ tape( 'the function supports a `y` stride', function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 5.0, 6.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 0.0, 0.0, 3.0, 4.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -237,8 +237,8 @@ tape( 'the function supports a `y` offset', function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 5.0, 6.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 1.0, 2.0, 3.0, 4.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -252,7 +252,7 @@ tape( 'the function returns a reference to the destination array', function test out = cswap( x.length, x, 1, 0, y, 1, 0 ); - t.strictEqual( out, y, 'same reference' ); + t.strictEqual( out, y, 'returns expected value' ); t.end(); }); @@ -274,12 +274,12 @@ tape( 'if provided an `N` parameter less than or equal to `0`, the function retu ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] ); cswap( -1, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'returns `x` unchanged' ); - t.deepEqual( viewY, ye, 'returns `y` unchanged' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); cswap( 0, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'returns `x` unchanged' ); - t.deepEqual( viewY, ye, 'returns `y` unchanged' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -323,8 +323,8 @@ tape( 'the function supports negative strides', function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 0.0, 0.0, 1.0, 2.0, 5.0, 6.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -367,8 +367,8 @@ tape( 'the function supports complex access patterns', function test( t ) { xe = new Float32Array( [ 1.0, 2.0, 0.0, 0.0, 5.0, 6.0, 0.0, 0.0 ] ); ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 7.0, 8.0, 3.0, 4.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -395,8 +395,8 @@ tape( 'if both strides are equal to `1`, the function efficiently swaps elements cswap( x.length, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); x = new Complex64Array( 120 ); y = new Complex64Array( x.length ); @@ -412,8 +412,8 @@ tape( 'if both strides are equal to `1`, the function efficiently swaps elements cswap( x.length, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); diff --git a/lib/node_modules/@stdlib/blas/base/cswap/test/test.ndarray.native.js b/lib/node_modules/@stdlib/blas/base/cswap/test/test.ndarray.native.js index 2e1ee0a053e..90a1c1ae191 100644 --- a/lib/node_modules/@stdlib/blas/base/cswap/test/test.ndarray.native.js +++ b/lib/node_modules/@stdlib/blas/base/cswap/test/test.ndarray.native.js @@ -45,7 +45,7 @@ tape( 'main export is a function', opts, function test( t ) { }); tape( 'the function has an arity of 7', opts, function test( t ) { - t.strictEqual( cswap.length, 7, 'arity of 7' ); + t.strictEqual( cswap.length, 7, 'returns expected value' ); t.end(); }); @@ -68,8 +68,8 @@ tape( 'the function swaps elements in `x` and `y`', opts, function test( t ) { cswap( x.length, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.notEqual( y, x, 'different references' ); t.end(); @@ -114,8 +114,8 @@ tape( 'the function supports an `x` stride', opts, function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 5.0, 6.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -158,8 +158,8 @@ tape( 'the function supports an `x` offset', opts, function test( t ) { xe = new Float32Array( [ 1.0, 2.0, 3.0, 4.0, 0.0, 0.0, 0.0, 0.0 ] ); ye = new Float32Array( [ 5.0, 6.0, 7.0, 8.0, 0.0, 0.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -202,8 +202,8 @@ tape( 'the function supports a `y` stride', opts, function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 5.0, 6.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 1.0, 2.0, 0.0, 0.0, 3.0, 4.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -246,8 +246,8 @@ tape( 'the function supports a `y` offset', opts, function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 5.0, 6.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 1.0, 2.0, 3.0, 4.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -261,7 +261,7 @@ tape( 'the function returns a reference to the destination array', opts, functio out = cswap( x.length, x, 1, 0, y, 1, 0 ); - t.strictEqual( out, y, 'same reference' ); + t.strictEqual( out, y, 'returns expected value' ); t.end(); }); @@ -283,12 +283,12 @@ tape( 'if provided an `N` parameter less than or equal to `0`, the function retu ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] ); cswap( -1, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'returns `x` unchanged' ); - t.deepEqual( viewY, ye, 'returns `y` unchanged' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); cswap( 0, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'returns `x` unchanged' ); - t.deepEqual( viewY, ye, 'returns `y` unchanged' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -332,8 +332,8 @@ tape( 'the function supports negative strides', opts, function test( t ) { xe = new Float32Array( [ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ] ); ye = new Float32Array( [ 0.0, 0.0, 1.0, 2.0, 5.0, 6.0, 0.0, 0.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -376,8 +376,8 @@ tape( 'the function supports complex access patterns', opts, function test( t ) xe = new Float32Array( [ 1.0, 2.0, 0.0, 0.0, 5.0, 6.0, 0.0, 0.0 ] ); ye = new Float32Array( [ 0.0, 0.0, 0.0, 0.0, 7.0, 8.0, 3.0, 4.0 ] ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); }); @@ -404,8 +404,8 @@ tape( 'if both strides are equal to `1`, the function efficiently swaps elements cswap( x.length, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); x = new Complex64Array( 120 ); y = new Complex64Array( x.length ); @@ -421,8 +421,8 @@ tape( 'if both strides are equal to `1`, the function efficiently swaps elements cswap( x.length, x, 1, 0, y, 1, 0 ); - t.deepEqual( viewX, xe, 'deep equal' ); - t.deepEqual( viewY, ye, 'deep equal' ); + t.deepEqual( viewX, xe, 'returns expected value' ); + t.deepEqual( viewY, ye, 'returns expected value' ); t.end(); });