chore: update descriptions, test descriptions and refactor benchmarks

lib/node_modules/@stdlib/math/base/special/maxf/README.md

@@ -20,7 +20,7 @@ limitations under the License.
 
 # maxf
 
-> Return the maximum value (single-precision).
+> Return the maximum single-precision floating-point number.
 
 <!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
 
@@ -42,7 +42,7 @@ var maxf = require( '@stdlib/math/base/special/maxf' );
 
 #### maxf( x, y )
 
-Returns the maximum value (single-precision).
+Returns the maximum single-precision floating-point number.
 
 ```javascript
 var v = maxf( 4.2, 3.14 );
@@ -131,7 +131,7 @@ for ( i = 0; i < 100; i++ ) {
 
 #### stdlib_base_maxf( x, y )
 
-Returns the maximum value (single-precision).
+Returns the maximum single-precision floating-point number.
 
 ```c
 float out = stdlib_base_maxf( 4.2f, 3.14f );

lib/node_modules/@stdlib/math/base/special/maxf/benchmark/benchmark.js

@@ -21,7 +21,7 @@
 // MODULES //
 
 var bench = require( '@stdlib/bench' );
-var randu = require( '@stdlib/random/base/randu' );
+var randu = require( '@stdlib/random/array/uniform' );
 var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
 var pkg = require( './../package.json' ).name;
 var maxf = require( './../lib' );
@@ -35,11 +35,12 @@ bench( pkg, function benchmark( b ) {
 	var z;
 	var i;
 
+	x = randu( 100, -100.0, 100.0 );
+	y = randu( 100, -100.0, 100.0 );
+
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu() * 1000.0 ) - 500.0;
-		y = ( randu() * 1000.0 ) - 500.0;
-		z = maxf( x, y );
+		z = maxf( x[ i % x.length ], y[ i % y.length ] );
 		if ( isnanf( z ) ) {
 			b.fail( 'should not return NaN' );
 		}

lib/node_modules/@stdlib/math/base/special/maxf/benchmark/benchmark.native.js

@@ -22,7 +22,7 @@
 
 var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
-var randu = require( '@stdlib/random/base/randu' );
+var randu = require( '@stdlib/random/array/uniform' );
 var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
@@ -44,11 +44,12 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 	var z;
 	var i;
 
+	x = randu( 100, -100.0, 100.0 );
+	y = randu( 100, -100.0, 100.0 );
+
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		x = ( randu() * 200.0 ) - 100.0;
-		y = ( randu() * 200.0 ) - 100.0;
-		z = maxf( x, y );
+		z = maxf( x[ i % x.length ], y[ i % y.length ] );
 		if ( isnanf( z ) ) {
 			b.fail( 'should not return NaN' );
 		}

lib/node_modules/@stdlib/math/base/special/maxf/benchmark/c/native/benchmark.c

@@ -92,16 +92,19 @@ static float rand_float( void ) {
 static double benchmark( void ) {
 	double elapsed;
 	double t;
-	float x;
-	float y;
+	float x[ 100 ];
+	float y[ 100 ];
 	float z;
 	int i;
 
+	for ( i = 0; i < 100; i++ ) {
+		x[ i ] = ( 200.0f * rand_float() ) - 100.0f;
+		y[ i ] = ( 200.0f * rand_float() ) - 100.0f;
+	}
+
 	t = tic();
 	for ( i = 0; i < ITERATIONS; i++ ) {
-		x = ( 200.0f * rand_float() ) - 100.0f;
-		y = ( 200.0f * rand_float() ) - 100.0f;
-		z = stdlib_base_maxf( x, y );
+		z = stdlib_base_maxf( x[ i % 100 ], y[ i % 100 ] );
 		if ( z != z ) {
 			printf( "should not return NaN\n" );
 			break;

lib/node_modules/@stdlib/math/base/special/maxf/docs/repl.txt

@@ -1,6 +1,6 @@
 
 {{alias}}( x, y )
-    Returns the maximum value (single-precision).
+    Returns the maximum single-precision floating-point number.
 
     If any argument is `NaN`, the function returns `NaN`.
 

lib/node_modules/@stdlib/math/base/special/maxf/docs/types/index.d.ts

@@ -19,7 +19,7 @@
 // TypeScript Version: 4.1
 
 /**
-* Returns the maximum value (single-precision).
+* Returns the maximum single-precision floating-point number.
 *
 * @param x - first number
 * @param y - second number

lib/node_modules/@stdlib/math/base/special/maxf/include/stdlib/math/base/special/maxf.h

@@ -27,7 +27,7 @@ extern "C" {
 #endif
 
 /**
-* Returns the maximum value (single-precision).
+* Returns the maximum single-precision floating-point number.
 */
 float stdlib_base_maxf( const float x, const float y );
 

lib/node_modules/@stdlib/math/base/special/maxf/lib/index.js

@@ -19,7 +19,7 @@
 'use strict';
 
 /**
-* Return the maximum value (single-precision).
+* Return the maximum single-precision floating-point number.
 *
 * @module @stdlib/math/base/special/maxf
 *

lib/node_modules/@stdlib/math/base/special/maxf/lib/main.js

@@ -28,7 +28,7 @@ var PINF = require( '@stdlib/constants/float32/pinf' );
 // MAIN //
 
 /**
-* Returns the maximum value (single-precision).
+* Returns the maximum single-precision floating-point number.
 *
 * @param {number} x - first number
 * @param {number} y - second number

lib/node_modules/@stdlib/math/base/special/maxf/lib/native.js

@@ -26,7 +26,7 @@ var addon = require( './../src/addon.node' );
 // MAIN //
 
 /**
-* Returns the maximum value (single-precision).
+* Returns the maximum single-precision floating-point number.
 *
 * @private
 * @param {number} x - first number

lib/node_modules/@stdlib/math/base/special/maxf/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stdlib/math/base/special/maxf",
   "version": "0.0.0",
-  "description": "Return the maximum value (single-precision).",
+  "description": "Return the maximum single-precision floating-point number.",
   "license": "Apache-2.0",
   "author": {
     "name": "The Stdlib Authors",

lib/node_modules/@stdlib/math/base/special/maxf/src/main.c

@@ -22,7 +22,7 @@
 #include "stdlib/constants/float32/pinf.h"
 
 /**
-* Returns the maximum value (single-precision).
+* Returns the maximum single-precision floating-point number.
 *
 * @param x       first number
 * @param y       second number

lib/node_modules/@stdlib/math/base/special/maxf/test/test.js

@@ -53,10 +53,10 @@ tape( 'the function returns `+Infinity` if provided `+Infinity`', function test(
 	var v;
 
 	v = maxf( PINF, 3.14 );
-	t.strictEqual( v, PINF, 'returns +infinity' );
+	t.strictEqual( v, PINF, 'returns expected value' );
 
 	v = maxf( 3.14, PINF );
-	t.strictEqual( v, PINF, 'returns +infinity' );
+	t.strictEqual( v, PINF, 'returns expected value' );
 
 	t.end();
 });
@@ -65,16 +65,16 @@ tape( 'the function returns a correctly signed zero', function test( t ) {
 	var v;
 
 	v = maxf( +0.0, -0.0 );
-	t.strictEqual( isPositiveZerof( v ), true, 'returns +0' );
+	t.strictEqual( isPositiveZerof( v ), true, 'returns expected value' );
 
 	v = maxf( -0.0, +0.0 );
-	t.strictEqual( isPositiveZerof( v ), true, 'returns +0' );
+	t.strictEqual( isPositiveZerof( v ), true, 'returns expected value' );
 
 	v = maxf( -0.0, -0.0 );
-	t.strictEqual( isNegativeZerof( v ), true, 'returns -0' );
+	t.strictEqual( isNegativeZerof( v ), true, 'returns expected value' );
 
 	v = maxf( +0.0, +0.0 );
-	t.strictEqual( isPositiveZerof( v ), true, 'returns +0' );
+	t.strictEqual( isPositiveZerof( v ), true, 'returns expected value' );
 
 	t.end();
 });
@@ -83,10 +83,10 @@ tape( 'the function returns the maximum value', function test( t ) {
 	var v;
 
 	v = maxf( float64ToFloat32( 4.2 ), float64ToFloat32( 3.14 ) );
-	t.strictEqual( v, float64ToFloat32( 4.2 ), 'returns max value' );
+	t.strictEqual( v, float64ToFloat32( 4.2 ), 'returns expected value' );
 
 	v = maxf( float64ToFloat32( -4.2 ), float64ToFloat32( 3.14 ) );
-	t.strictEqual( v, float64ToFloat32( 3.14 ), 'returns max value' );
+	t.strictEqual( v, float64ToFloat32( 3.14 ), 'returns expected value' );
 
 	t.end();
 });

lib/node_modules/@stdlib/math/base/special/maxf/test/test.native.js

@@ -62,10 +62,10 @@ tape( 'the function returns `+Infinity` if provided `+Infinity`', opts, function
 	var v;
 
 	v = maxf( PINF, 3.14 );
-	t.strictEqual( v, PINF, 'returns +infinity' );
+	t.strictEqual( v, PINF, 'returns expected value' );
 
 	v = maxf( 3.14, PINF );
-	t.strictEqual( v, PINF, 'returns +infinity' );
+	t.strictEqual( v, PINF, 'returns expected value' );
 
 	t.end();
 });
@@ -74,16 +74,16 @@ tape( 'the function returns a correctly signed zero', opts, function test( t ) {
 	var v;
 
 	v = maxf( +0.0, -0.0 );
-	t.strictEqual( isPositiveZerof( v ), true, 'returns +0' );
+	t.strictEqual( isPositiveZerof( v ), true, 'returns expected value' );
 
 	v = maxf( -0.0, +0.0 );
-	t.strictEqual( isPositiveZerof( v ), true, 'returns +0' );
+	t.strictEqual( isPositiveZerof( v ), true, 'returns expected value' );
 
 	v = maxf( -0.0, -0.0 );
-	t.strictEqual( isNegativeZerof( v ), true, 'returns -0' );
+	t.strictEqual( isNegativeZerof( v ), true, 'returns expected value' );
 
 	v = maxf( +0.0, +0.0 );
-	t.strictEqual( isPositiveZerof( v ), true, 'returns +0' );
+	t.strictEqual( isPositiveZerof( v ), true, 'returns expected value' );
 
 	t.end();
 });
@@ -92,10 +92,10 @@ tape( 'the function returns the maximum value', opts, function test( t ) {
 	var v;
 
 	v = maxf( float64ToFloat32( 4.2 ), float64ToFloat32( 3.14 ) );
-	t.strictEqual( v, float64ToFloat32( 4.2 ), 'returns max value' );
+	t.strictEqual( v, float64ToFloat32( 4.2 ), 'returns expected value' );
 
 	v = maxf( float64ToFloat32( -4.2 ), float64ToFloat32( 3.14 ) );
-	t.strictEqual( v, float64ToFloat32( 3.14 ), 'returns max value' );
+	t.strictEqual( v, float64ToFloat32( 3.14 ), 'returns expected value' );
 
 	t.end();
 });