docs: improve doctests in complex/base/wrap-function

PR-URL: #8666
Ref: #8641
Co-authored-by: Athan Reines <kgryte@gmail.com>
Reviewed-by: Athan Reines <kgryte@gmail.com>

Author: aryan7071

lib/node_modules/@stdlib/complex/base/wrap-function/README.md

@@ -86,24 +86,16 @@ The function accepts the following arguments:
 ```javascript
 var Complex64 = require( '@stdlib/complex/float32/ctor' );
 var caddf = require( '@stdlib/complex/float32/base/add' );
-var realf = require( '@stdlib/complex/float32/real' );
-var imagf = require( '@stdlib/complex/float32/imag' );
 var wrap = require( '@stdlib/complex/base/wrap-function' );
 
 var f = wrap( caddf, 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/wrap-function/docs/repl.txt

@@ -36,11 +36,7 @@
     --------
     > var f = {{alias}}( {{alias:@stdlib/complex/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/wrap-function/docs/types/index.d.ts

@@ -193,13 +193,7 @@ type Constructor = new( re: number, im: number ) => ComplexLike;
 * // ...
 *
 * 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 ): Nullary;
 
@@ -220,21 +214,13 @@ declare function wrap( fcn: Nullary, nargs: 0, ctor: Constructor ): Nullary;
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
 * var cidentityf = require( '@stdlib/complex/float32/base/identity' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * var f = wrap( cidentityf, 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;
 
@@ -255,21 +241,13 @@ declare function wrap( fcn: Unary, nargs: 1, ctor: Constructor ): WrappedUnary;
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
 * var caddf = require( '@stdlib/complex/float32/base/add' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * var f = wrap( caddf, 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;
 

lib/node_modules/@stdlib/complex/base/wrap-function/examples/index.js

@@ -20,22 +20,14 @@
 
 var Complex64 = require( '@stdlib/complex/float32/ctor' );
 var caddf = require( '@stdlib/complex/float32/base/add' );
-var realf = require( '@stdlib/complex/float32/real' );
-var imagf = require( '@stdlib/complex/float32/imag' );
 var wrap = require( './../lib' );
 
 var f = wrap( caddf, 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/wrap-function/lib/index.js

@@ -26,22 +26,14 @@
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
 * var caddf = require( '@stdlib/complex/float32/base/add' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 * var wrap = require( '@stdlib/complex/base/wrap-function' );
 *
 * var f = wrap( caddf, 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 ]
 */
 
 // MODULES //

lib/node_modules/@stdlib/complex/base/wrap-function/lib/main.js

@@ -53,21 +53,13 @@ var T = 'number';
 * @example
 * var Complex64 = require( '@stdlib/complex/float32/ctor' );
 * var caddf = require( '@stdlib/complex/float32/base/add' );
-* var realf = require( '@stdlib/complex/float32/real' );
-* var imagf = require( '@stdlib/complex/float32/imag' );
 *
 * var f = wrap( caddf, 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 ]
 */
 function wrap( fcn, nargs, ctor ) {
 	var fcns;