Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2026-01-15)
+## Unreleased (2026-01-16)
 
 <section class="features">
 
@@ -716,6 +716,7 @@ A total of 82 issues were closed in this release:
 
 <details>
 
+-   [`8da46ee`](https://github.com/stdlib-js/stdlib/commit/8da46ee80a830f024f0b347b84e48e239b9eaee9) - **docs:** improve doctests for complex number instances in `math/base/special/cfloor` [(#9766)](https://github.com/stdlib-js/stdlib/pull/9766) _(by Vishal Gaikwad)_
 -   [`a0f0513`](https://github.com/stdlib-js/stdlib/commit/a0f05135e37f5343ba7870b16e124ff2d642643d) - **chore:** fix EditorConfig lint errors [(#9755)](https://github.com/stdlib-js/stdlib/pull/9755) _(by Divyanshu)_
 -   [`bfc8c3a`](https://github.com/stdlib-js/stdlib/commit/bfc8c3a7bcebf1a049c9e457ab440f540fd5c7a9) - **chore:** use one asterisk for license comment in TS files _(by Philipp Burckhardt)_
 -   [`b6d9f4d`](https://github.com/stdlib-js/stdlib/commit/b6d9f4d465b6a0ec5ceac8d3d5dda7aaa4c6d8c6) - **chore:** fix JavaScript lint errors [(#9659)](https://github.com/stdlib-js/stdlib/pull/9659) _(by Shreelaxmi Hegde, Athan Reines)_
@@ -1892,7 +1893,7 @@ A total of 82 issues were closed in this release:
 
 ### Contributors
 
-A total of 65 people contributed to this release. Thank you to the following contributors:
+A total of 66 people contributed to this release. Thank you to the following contributors:
 
 -   Aayush Khanna
 -   Aman Singh
@@ -1954,6 +1955,7 @@ A total of 65 people contributed to this release. Thank you to the following con
 -   Shabareesh Shetty
 -   Shaswata Panda
 -   Shreelaxmi Hegde
+-   Vishal Gaikwad
 -   Vivek Maurya
 -   Yohan Park
 -   Yugal Kaushik

base/special/cfloor/README.md

@@ -36,44 +36,19 @@ Rounds a double-precision complex floating-point number toward negative infinity
 
 ```javascript
 var Complex128 = require( '@stdlib/complex/float64/ctor' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var v = cfloor( new Complex128( -4.2, 5.5 ) );
-// returns <Complex128>
-
-var re = real( v );
-// returns -5.0
-
-var im = imag( v );
-// returns 5.0
+// returns <Complex128>[ -5.0, 5.0 ]
 
 v = cfloor( new Complex128( 9.99999, 0.1 ) );
-// returns <Complex128>
-
-re = real( v );
-// returns 9.0
-
-im = imag( v );
-// returns 0.0
+// returns <Complex128>[ 9.0, 0.0 ]
 
 v = cfloor( new Complex128( 0.0, 0.0 ) );
-// returns <Complex128>
-
-re = real( v );
-// returns 0.0
-
-im = imag( v );
-// returns 0.0
+// returns <Complex128>[ 0.0, 0.0 ]
 
 v = cfloor( new Complex128( NaN, NaN ) );
-// returns <Complex128>
-
-re = real( v );
-// returns NaN
+// returns <Complex128>[ NaN, NaN ]
 
-im = imag( v );
-// returns NaN
 ```
 
 </section>

base/special/cfloor/docs/repl.txt

@@ -16,11 +16,7 @@
     Examples
     --------
     > var v = {{alias}}( new {{alias:@stdlib/complex/float64/ctor}}( 5.5, 3.3 ) )
-    <Complex128>
-    > var re = {{alias:@stdlib/complex/float64/real}}( v )
-    5.0
-    > var im = {{alias:@stdlib/complex/float64/imag}}( v )
-    3.0
+    <Complex128>[ 5.0, 3.0 ]
 
     See Also
     --------

base/special/cfloor/docs/types/index.d.ts

@@ -30,17 +30,9 @@ import { Complex128 } from '@stdlib/types/complex';
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 *
 * var v = cfloor( new Complex128( 5.5, 3.3 ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns 5.0
-*
-* var im = imag( v );
-* // returns 3.0
+* // returns <Complex128>[ 5.0, 3.0 ]
 */
 declare function cfloor( z: Complex128 ): Complex128;
 

base/special/cfloor/lib/index.js

@@ -25,63 +25,31 @@
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 * var cfloor = require( '@stdlib/math/base/special/cfloor' );
 *
 * var v = cfloor( new Complex128( -4.2, 5.5 ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns -5.0
-*
-* var im = imag( v );
-* // returns 5.0
+* // returns <Complex128>[ -5.0, 5.0 ]
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 * var cfloor = require( '@stdlib/math/base/special/cfloor' );
 *
 * var v = cfloor( new Complex128( 9.99999, 0.1 ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns 9.0
-*
-* var im = imag( v );
-* // returns 0.0
+* // returns <Complex128>[ 9.0, 0.0 ]
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 * var cfloor = require( '@stdlib/math/base/special/cfloor' );
 *
 * var v = cfloor( new Complex128( 0.0, 0.0 ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns 0.0
-*
-* var im = imag( v );
-* // returns 0.0
+* // returns <Complex128>[ 0.0, 0.0 ]
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 * var cfloor = require( '@stdlib/math/base/special/cfloor' );
 *
 * var v = cfloor( new Complex128( NaN, NaN ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns NaN
-*
-* var im = imag( v );
-* // returns NaN
+* // returns <Complex128>[ NaN, NaN ]
 */
 
 // MODULES //

base/special/cfloor/lib/main.js

@@ -36,59 +36,28 @@ var imag = require( '@stdlib/complex/float64/imag' );
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 *
 * var v = cfloor( new Complex128( -4.2, 5.5 ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns -5.0
-*
-* var im = imag( v );
-* // returns 5.0
+* // returns <Complex128>[ -5.0, 5.0 ]
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 *
 * var v = cfloor( new Complex128( 9.99999, 0.1 ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns 9.0
-*
-* var im = imag( v );
-* // returns 0.0
+* // returns <Complex128>[ 9.0, 0.0 ]
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 *
 * var v = cfloor( new Complex128( 0.0, 0.0 ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns 0.0
-*
-* var im = imag( v );
-* // returns 0.0
+* // returns <Complex128>[ 0.0, 0.0 ]
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 *
 * var v = cfloor( new Complex128( NaN, NaN ) );
-* // returns <Complex128>
-*
-* var re = real( v );
-* // returns NaN
-*
-* var im = imag( v );
-* // returns NaN
+* // returns <Complex128>[ NaN, NaN ]
+
 */
 function cfloor( z ) {
 	return new Complex128( floor( real( z ) ), floor( imag( z ) ) );

base/special/cfloor/lib/native.js

@@ -35,17 +35,10 @@ var addon = require( './../src/addon.node' );
 *
 * @example
 * var Complex128 = require( '@stdlib/complex/float64/ctor' );
-* var real = require( '@stdlib/complex/float64/real' );
-* var imag = require( '@stdlib/complex/float64/imag' );
 *
 * var v = cfloor( new Complex128( -1.5, 2.5 ) );
-* // returns <Complex128>
+* // returns <Complex128>[ -2.0, 2.0 ]
 *
-* var re = real( v );
-* // returns -2.0
-*
-* var im = imag( v );
-* // returns 2.0
 */
 function cfloor( z ) {
 	var v = addon( z );