docs: improve doctests for complex number instances in complex/base/cast-return

lib/node_modules/@stdlib/complex/base/cast-return/README.md

@@ -86,24 +86,16 @@ The function accepts the following arguments:
 ```javascript
 var Complex64 = require( '@stdlib/complex/float32/ctor' );
 var addf = require( '@stdlib/number/float32/base/add' );
-var realf = require( '@stdlib/complex/float32/real' );
-var imagf = require( '@stdlib/complex/float32/imag' );
 var castReturn = require( '@stdlib/complex/base/cast-return' );
 
 var f = castReturn( addf, 2, Complex64 );
 
 // ...
 
 var z = f( 3.0, 4.0 );
-// returns <Complex64>
+// returns <Complex64>[ 7.0, 0.0 ]
 
-var re = realf( z );
-// returns 7.0
-
-var im = imagf( z );
-// returns 0.0
-
-console.log( '%d + %di', re, im );
+console.log( z.toString() );
 // => '7 + 0i'
 ```
 

lib/node_modules/@stdlib/complex/base/cast-return/docs/repl.txt

@@ -34,11 +34,7 @@
     --------
     > var f = {{alias}}( {{alias:@stdlib/number/float32/base/add}}, 2, {{alias:@stdlib/complex/float32/ctor}} );
     > var z = f( 3.0, 4.0 )
-    <Complex64>
-    > var re = {{alias:@stdlib/complex/float32/real}}( z )
-    7.0
-    > var im = {{alias:@stdlib/complex/float32/imag}}( z )
-    0.0
+    <Complex64>[ 7.0, 0.0 ]
 
     See Also
     --------

lib/node_modules/@stdlib/complex/base/cast-return/docs/types/index.d.ts

@@ -47,7 +47,7 @@
 * @param x - input value
 * @returns result
 */
 type Unary = ( x: any ) => RealOrComplex;
 
 /**
 * Unary function returning a complex number.
@@ -55,7 +55,7 @@
 * @param x - input value
 * @returns result
 */
 type WrappedUnary = ( x: any ) => ComplexLike;
 
 /**
 * Binary function returning either a real or complex number.
@@ -64,7 +64,7 @@
 * @param y - input value
 * @returns result
 */
 type Binary = ( x: any, y: any ) => RealOrComplex;
 
 /**
 * Binary function returning a complex number.
@@ -73,7 +73,7 @@
 * @param y - input value
 * @returns result
 */
 type WrappedBinary = ( x: any, y: any ) => ComplexLike;
 
 /**
 * Ternary function returning either a real or complex number.
@@ -83,7 +83,7 @@
 * @param z - input value
 * @returns result
 */
 type Ternary = ( x: any, y: any, z: any ) => RealOrComplex;
 
 /**
 * Ternary function returning a complex number.
@@ -93,7 +93,7 @@
 * @param z - input value
 * @returns result
 */
 type WrappedTernary = ( x: any, y: any, z: any ) => ComplexLike;
 
 /**
 * Quaternary function returning either a real or complex number.
@@ -187,22 +187,14 @@
 *
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 * var randu = require( '@stdlib/random/base/randu' );
 *
 * var f = wrap( randu, 0, Complex64 );
 *
 * // ...
 *
 * var z = f();
-* // returns <Complex64>
-*
-* var re = realf( z );
-* // returns <number>
-*
-* var im = imagf( z );
-* // returns <number>
+* // e.g., returns <Complex64>[ <number>, <number> ]
 */
 declare function wrap( fcn: Nullary, nargs: 0, ctor: Constructor ): WrappedNullary;
 
@@ -223,21 +215,13 @@
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
 * var identityf = require( '@stdlib/number/float32/base/identity' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * var f = wrap( identityf, 1, Complex64 );
 *
 * // ...
 *
 * var z = f( 3.0 );
-* // returns <Complex64>
-*
-* var re = realf( z );
-* // returns 3.0
-*
-* var im = imagf( z );
-* // returns 0.0
+* // returns <Complex64>[ 3.0, 0.0 ]
 */
 declare function wrap( fcn: Unary, nargs: 1, ctor: Constructor ): WrappedUnary;
 
@@ -258,21 +242,13 @@
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
 * var addf = require( '@stdlib/number/float32/base/add' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * var f = wrap( addf, 2, Complex64 );
 *
 * // ...
 *
 * var z = f( 3.0, 4.0 );
-* // returns <Complex64>
-*
-* var re = realf( z );
-* // returns 7.0
-*
-* var im = imagf( z );
-* // returns 0.0
+* // returns <Complex64>[ 7.0, 0.0 ]
 */
 declare function wrap( fcn: Binary, nargs: 2, ctor: Constructor ): WrappedBinary;
 
@@ -292,8 +268,6 @@
 *
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * function add( x, y, z ) {
 *     return x + y + z;
@@ -304,13 +278,7 @@
 * // ...
 *
 * var z = f( 3.0, 4.0, 5.0 );
-* // returns <Complex64>
-*
-* var re = realf( z );
-* // returns 12.0
-*
-* var im = imagf( z );
-* // returns 0.0
+* // returns <Complex64>[ 12.0, 0.0 ]
 */
 declare function wrap( fcn: Ternary, nargs: 3, ctor: Constructor ): WrappedTernary;
 
@@ -330,8 +298,6 @@
 *
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * function add( x, y, z, w ) {
 *     return x + y + z + w;
@@ -342,13 +308,7 @@
 * // ...
 *
 * var z = f( 3.0, 4.0, 5.0, 6.0 );
-* // returns <Complex64>
-*
-* var re = realf( z );
-* // returns 18.0
-*
-* var im = imagf( z );
-* // returns 0.0
+* // returns <Complex64>[ 18.0, 0.0 ]
 */
 declare function wrap( fcn: Quaternary, nargs: 4, ctor: Constructor ): WrappedQuaternary;
 
@@ -368,8 +328,6 @@
 *
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * function add( x, y, z, w, v ) {
 *     return x + y + z + w + v;
@@ -380,13 +338,7 @@
 * // ...
 *
 * var z = f( 3.0, 4.0, 5.0, 6.0, 7.0 );
-* // returns <Complex64>
-*
-* var re = realf( z );
-* // returns 25.0
-*
-* var im = imagf( z );
-* // returns 0.0
+* // returns <Complex64>[ 25.0, 0.0 ]
 */
 declare function wrap( fcn: Quinary, nargs: 5, ctor: Constructor ): WrappedQuinary;
 
@@ -406,8 +358,6 @@
 *
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * function add( x, y, z, w, v, t ) {
 *     return x + y + z + w + v + t;
@@ -418,13 +368,7 @@
 * // ...
 *
 * var z = f( 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 );
-* // returns <Complex64>
-*
-* var re = realf( z );
-* // returns 33.0
-*
-* var im = imagf( z );
-* // returns 0.0
+* // returns <Complex64>[ 33.0, 0.0 ]
 */
 declare function wrap( fcn: Nary, nargs: number, ctor: Constructor ): WrappedNary;
 

lib/node_modules/@stdlib/complex/base/cast-return/examples/index.js

@@ -20,22 +20,15 @@
 
 var Complex64 = require( '@stdlib/complex/float32/ctor' );
 var addf = require( '@stdlib/number/float32/base/add' );
-var realf = require( '@stdlib/complex/float32/real' );
-var imagf = require( '@stdlib/complex/float32/imag' );
 var castReturn = require( './../lib' );
 
 var f = castReturn( addf, 2, Complex64 );
 
 // ...
 
 var z = f( 3.0, 4.0 );
-// returns <Complex64>
+// returns <Complex64>[ 7.0, 0.0]
 
-var re = realf( z );
-// returns 7.0
 
-var im = imagf( z );
-// returns 0.0
-
-console.log( '%d + %di', re, im );
-// => '7 + 0i'
+console.log( z.toString() );
+// => '7 + 0i'  

lib/node_modules/@stdlib/complex/base/cast-return/lib/index.js

@@ -18,7 +18,7 @@
 
 'use strict';
 
 /**
 * Wrap a function and casts a function's return value to a complex number.
 *
 * @module @stdlib/complex/base/cast-return
@@ -26,22 +26,16 @@
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
 * var addf = require( '@stdlib/number/float32/base/add' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 * var castReturn = require( '@stdlib/complex/base/cast-return' );
 *
 * var f = castReturn( addf, 2, Complex64 );
 *
 * // ...
 *
 * var z = f( 3.0, 4.0 );
-* // returns <Complex64>
+* // returns <Complex64>[ 7.0, 0.0 ]
 *
-* var re = realf( z );
-* // returns 7.0
-*
-* var im = imagf( z );
-* // returns 0.0
+* 
 */
 
 // MODULES //

lib/node_modules/@stdlib/complex/base/cast-return/lib/main.js

@@ -53,21 +53,14 @@ var T = 'number';
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
 * var addf = require( '@stdlib/number/float32/base/add' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * var f = wrap( addf, 2, Complex64 );
 *
 * // ...
 *
 * var z = f( 3.0, 4.0 );
-* // returns <Complex64>
+* // returns <Complex64>[ 7.0, 0.0 ]
 *
-* var re = realf( z );
-* // returns 7.0
-*
-* var im = imagf( z );
-* // returns 0.0
 */
 function wrap( fcn, nargs, ctor ) {
 	var fcns;