Merge branch 'develop' of https://github.com/stdlib-js/stdlib into develop

Author: kgryte

CONTRIBUTORS

@@ -174,6 +174,7 @@ Utkarsh <http://[email protected]>
 Utkarsh Raj <[email protected]>
 UtkershBasnet <[email protected]>
 Vaibhav Patel <[email protected]>
+Vara Rahul Rajana <[email protected]>
 Varad Gupta <[email protected]>
 Vinit Pandit <[email protected]>
 Vivek Maurya <[email protected]>

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

@@ -87,8 +87,8 @@
           },
           "domain": [
             {
-              "min": "-1",
-              "max": "1"
+              "min": -1,
+              "max": 1
             }
           ],
           "rand": {

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

@@ -84,8 +84,8 @@
           },
           "domain": [
             {
-              "min": "-1",
-              "max": "1"
+              "min": -1,
+              "max": 1
             }
           ],
           "rand": {

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

@@ -84,8 +84,8 @@
           },
           "domain": [
             {
-              "min": "-1",
-              "max": "1"
+              "min": -1,
+              "max": 1
             }
           ],
           "rand": {

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

@@ -87,8 +87,8 @@
           },
           "domain": [
             {
-              "min": "-1",
-              "max": "1"
+              "min": -1,
+              "max": 1
             }
           ],
           "rand": {

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

@@ -91,7 +91,7 @@
           },
           "domain": [
             {
-              "min": "1",
+              "min": 1,
               "max": "infinity"
             }
           ],

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

@@ -28,16 +28,20 @@
 * var v = j0( 0.0 );
 * // returns 1.0
 *
-* v = j0( 1.0 );
+* @example
+* var v = j0( 1.0 );
 * // returns ~0.765
 *
-* v = j0( Infinity );
+* @example
+* var v = j0( Infinity );
 * // returns 0.0
 *
-* v = j0( -Infinity );
+* @example
+* var v = j0( -Infinity );
 * // returns 0.0
 *
-* v = j0( NaN );
+* @example
+* var v = j0( NaN );
 * // returns NaN
 */
 declare function j0( x: number ): number;

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

@@ -68,16 +68,20 @@ var sc = [ 0.0, 0.0 ];
 * var v = j0( 0.0 );
 * // returns 1.0
 *
-* v = j0( 1.0 );
+* @example
+* var v = j0( 1.0 );
 * // returns ~0.765
 *
-* v = j0( Infinity );
+* @example
+* var v = j0( Infinity );
 * // returns 0.0
 *
-* v = j0( -Infinity );
+* @example
+* var v = j0( -Infinity );
 * // returns 0.0
 *
-* v = j0( NaN );
+* @example
+* var v = j0( NaN );
 * // returns NaN
 */
 function j0( x ) {

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

@@ -36,16 +36,20 @@ var addon = require( './../src/addon.node' );
 * var v = j0( 0.0 );
 * // returns 1.0
 *
-* v = j0( 1.0 );
+* @example
+* var v = j0( 1.0 );
 * // returns ~0.765
 *
-* v = j0( Infinity );
+* @example
+* var v = j0( Infinity );
 * // returns 0.0
 *
-* v = j0( -Infinity );
+* @example
+* var v = j0( -Infinity );
 * // returns 0.0
 *
-* v = j0( NaN );
+* @example
+* var v = j0( NaN );
 * // returns NaN
 */
 function j0( x ) {

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

@@ -32,16 +32,20 @@
 * var v = j1( 0.0 );
 * // returns 0.0
 *
-* v = j1( 1.0 );
+* @example
+* var v = j1( 1.0 );
 * // returns ~0.440
 *
-* v = j1( Infinity );
+* @example
+* var v = j1( Infinity );
 * // returns 0.0
 *
-* v = j1( -Infinity );
+* @example
+* var v = j1( -Infinity );
 * // returns 0.0
 *
-* v = j1( NaN );
+* @example
+* var v = j1( NaN );
 * // returns NaN
 */
 declare function j1( x: number ): number;

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

@@ -73,16 +73,20 @@ var sc = [ 0.0, 0.0 ];
 * var v = j1( 0.0 );
 * // returns 0.0
 *
-* v = j1( 1.0 );
+* @example
+* var v = j1( 1.0 );
 * // returns ~0.440
 *
-* v = j1( Infinity );
+* @example
+* var v = j1( Infinity );
 * // returns 0.0
 *
-* v = j1( -Infinity );
+* @example
+* var v = j1( -Infinity );
 * // returns 0.0
 *
-* v = j1( NaN );
+* @example
+* var v = j1( NaN );
 * // returns NaN
 */
 function j1( x ) {

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

@@ -33,16 +33,20 @@ var addon = require( './../src/addon.node' );
 * var v = j1( 0.0 );
 * // returns 0.0
 *
-* v = j1( 1.0 );
+* @example
+* var v = j1( 1.0 );
 * // returns ~0.440
 *
-* v = j1( Infinity );
+* @example
+* var v = j1( Infinity );
 * // returns 0.0
 *
-* v = j1( -Infinity );
+* @example
+* var v = j1( -Infinity );
 * // returns 0.0
 *
-* v = j1( NaN );
+* @example
+* var v = j1( NaN );
 * // returns NaN
 */
 function j1( x ) {

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

@@ -32,19 +32,24 @@
 * var v = y0( 0.0 );
 * // returns -Infinity
 *
-* v = y0( 1.0 );
+* @example
+* var v = y0( 1.0 );
 * // returns ~0.088
 *
-* v = y0( -1.0 );
+* @example
+* var v = y0( -1.0 );
 * // returns NaN
 *
-* v = y0( Infinity );
+* @example
+* var v = y0( Infinity );
 * // returns 0.0
 *
-* v = y0( -Infinity );
+* @example
+* var v = y0( -Infinity );
 * // returns NaN
 *
-* v = y0( NaN );
+* @example
+* var v = y0( NaN );
 * // returns NaN
 */
 declare function y0( x: number ): number;

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

@@ -83,19 +83,24 @@ var sc = [ 0.0, 0.0 ];
 * var v = y0( 0.0 );
 * // returns -Infinity
 *
-* v = y0( 1.0 );
+* @example
+* var v = y0( 1.0 );
 * // returns ~0.088
 *
-* v = y0( -1.0 );
+* @example
+* var v = y0( -1.0 );
 * // returns NaN
 *
-* v = y0( Infinity );
+* @example
+* var v = y0( Infinity );
 * // returns 0.0
 *
-* v = y0( -Infinity );
+* @example
+* var v = y0( -Infinity );
 * // returns NaN
 *
-* v = y0( NaN );
+* @example
+* var v = y0( NaN );
 * // returns NaN
 */
 function y0( x ) {

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

@@ -36,19 +36,24 @@ var addon = require( './../src/addon.node' );
 * var v = y0( 0.0 );
 * // returns -Infinity
 *
-* v = y0( 1.0 );
+* @example
+* var v = y0( 1.0 );
 * // returns ~0.088
 *
-* v = y0( -1.0 );
+* @example
+* var v = y0( -1.0 );
 * // returns NaN
 *
-* v = y0( Infinity );
+* @example
+* var v = y0( Infinity );
 * // returns 0.0
 *
-* v = y0( -Infinity );
+* @example
+* var v = y0( -Infinity );
 * // returns NaN
 *
-* v = y0( NaN );
+* @example
+* var v = y0( NaN );
 * // returns NaN
 */
 function y0( x ) {

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

@@ -26,6 +26,7 @@ var uniform = require( '@stdlib/random/base/uniform' );
 var isnan = require( '@stdlib/math/base/assert/is-nan' );
 var Complex128 = require( '@stdlib/complex/float64/ctor' );
 var real = require( '@stdlib/complex/float64/real' );
+var imag = require( '@stdlib/complex/float64/imag' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
 
@@ -50,7 +51,6 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 		new Complex128( uniform( -500.0, 500.0 ), uniform( -500.0, 500.0 ) ),
 		new Complex128( uniform( -500.0, 500.0 ), uniform( -500.0, 500.0 ) )
 	];
-
 	v = uniform( -500.0, 500.0 );
 
 	b.tic();
@@ -61,7 +61,7 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 		}
 	}
 	b.toc();
-	if ( isnan( real( y ) ) ) {
+	if ( isnan( imag( y ) ) ) {
 		b.fail( 'should not return NaN' );
 	}
 	b.pass( 'benchmark finished' );

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

@@ -131,19 +131,28 @@ for ( i = 0; i < 100; i++ ) {
 Returns a single-precision complex floating-point number with the same magnitude as `z` and the sign of `y*z`.
 
 ```c
-#include <complex.h>
+#include "stdlib/complex/float32/ctor.h"
+#include "stdlib/complex/float32/real.h"
+#include "stdlib/complex/float32/imag.h"
 
-float complex y = stdlib_base_cflipsignf( 2.0-1.0*I, -1.0 );
-// returns -2.0+1.0*I
+stdlib_complex64_t z = stdlib_complex64( 2.5f, -1.5f );
+
+stdlib_complex64_t out = stdlib_base_cflipsignf( z, -1.0f );
+
+float re = stdlib_complex64_real( out );
+// returns -2.5f
+
+float im = stdlib_complex64_imag( out );
+// returns 1.5f
 ```
 
 The function accepts the following arguments:
 
--   **z**: `[in] float complex` input value.
+-   **z**: `[in] stdlib_complex64_t` input value.
 -   **y**: `[in] float` number from which to derive the sign.
 
 ```c
-float complex stdlib_base_cflipsignf( const float complex z, const float y );
+stdlib_complex64_t stdlib_base_cflipsignf( const stdlib_complex64_t z, const float y );
 ```
 
 </section>
@@ -166,19 +175,31 @@ float complex stdlib_base_cflipsignf( const float complex z, const float y );
 
 ```c
 #include "stdlib/math/base/special/cflipsignf.h"
+#include "stdlib/complex/float32/ctor.h"
+#include "stdlib/complex/float32/reim.h"
 #include <stdio.h>
-#include <complex.h>
 
 int main( void ) {
-    const float complex x[] = { 3.14f+1.5f*I, -3.14f-1.5f*I, 0.0f+0.0f*I, 0.0f/0.0f+0.0f/0.0f*I };
-
-    float complex v;
-    float complex y;
+    const stdlib_complex64_t x[] = {
+        stdlib_complex64( 3.14f, 1.5f ),
+        stdlib_complex64( -3.14f, -1.5f ),
+        stdlib_complex64( 0.0f, 0.0f ),
+        stdlib_complex64( 0.0f/0.0f, 0.0f/0.0f )
+    };
+
+    stdlib_complex64_t v;
+    stdlib_complex64_t y;
+    float re1;
+    float im1;
+    float re2;
+    float im2;
     int i;
     for ( i = 0; i < 4; i++ ) {
         v = x[ i ];
         y = stdlib_base_cflipsignf( v, -1.0f );
-        printf( "cflipsignf(%f + %fi, %f) = %f + %fi\n", crealf( v ), cimagf( v ), -1.0f, crealf( y ), cimagf( y ) );
+        stdlib_complex64_reim( v, &re1, &im1 );
+        stdlib_complex64_reim( y, &re2, &im2 );
+        printf( "cflipsignf(%f + %fi, %f) = %f + %fi\n", re1, im1, -1.0f, re2, im2 );
     }
 }
 ```