Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -4,12 +4,13 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2025-07-05)
+## Unreleased (2025-08-13)
 
 <section class="features">
 
 ### Features
 
+-   [`dfbf338`](https://github.com/stdlib-js/stdlib/commit/dfbf3388bb499ec7ec5f453758acec3e6d18ee0b) - add `assign` and `strided` methods to `complex/float64/base/div` [(#7771)](https://github.com/stdlib-js/stdlib/pull/7771)
 -   [`afa2318`](https://github.com/stdlib-js/stdlib/commit/afa231834cb55bc1f0fb01d16b4cb81e7d435a35) - add `complex/float64/base/div`
 
 </section>
@@ -22,6 +23,7 @@
 
 <details>
 
+-   [`dfbf338`](https://github.com/stdlib-js/stdlib/commit/dfbf3388bb499ec7ec5f453758acec3e6d18ee0b) - **feat:** add `assign` and `strided` methods to `complex/float64/base/div` [(#7771)](https://github.com/stdlib-js/stdlib/pull/7771) _(by Aayush Khanna, stdlib-bot)_
 -   [`7cfd30f`](https://github.com/stdlib-js/stdlib/commit/7cfd30f9518e86adde577c3ebaacfd874e2cc651) - **test:** add appropriate values in test cases [(#7557)](https://github.com/stdlib-js/stdlib/pull/7557) _(by Shabareesh Shetty, Athan Reines)_
 -   [`6aeced9`](https://github.com/stdlib-js/stdlib/commit/6aeced9c39c38399d41e0da9a63ba3729452470b) - **docs:** update examples for `complex/float64/base/div` [(#7266)](https://github.com/stdlib-js/stdlib/pull/7266) _(by Shabareesh Shetty)_
 -   [`4821a02`](https://github.com/stdlib-js/stdlib/commit/4821a020f23d86279b8a487509afb4aca176dd57) - **chore:** change examples for `complex/float64/base/div` [(#7180)](https://github.com/stdlib-js/stdlib/pull/7180) _(by Shabareesh Shetty)_
@@ -40,8 +42,9 @@
 
 ### Contributors
 
-A total of 4 people contributed to this release. Thank you to the following contributors:
+A total of 5 people contributed to this release. Thank you to the following contributors:
 
+-   Aayush Khanna
 -   Athan Reines
 -   Gururaj Gurram
 -   Karan Anand

CONTRIBUTORS

@@ -9,9 +9,11 @@ Abdelrahman Samir <60700731+abdelrahman04@users.noreply.github.com>
 Abdul Kaium <97376242+impawstarlight@users.noreply.github.com>
 Abhay Punia <156515195+Hecker165@users.noreply.github.com>
 Abhijit Raut <abhijitmraut8010@gmail.com>
+Abhishek G <166795493+AbhishekG-Codes@users.noreply.github.com>
 Abhishek Jain <40913033+abhishekblue@users.noreply.github.com>
 Adarsh Palaskar <adarshpalaskar99@gmail.com>
 Aditya Sapra <adityaework@gmail.com>
+Aditya Singh <adityasinghk099@gmail.com>
 Ahmed Atwa <Ahmedatwa866@yahoo.com>
 Ahmed Kashkoush <ahmedkashkoush464@gmail.com>
 Ahmed Khaled <kahmd1444@gmail.com>
@@ -23,12 +25,16 @@ Aman Bhansali <bhansali.1@iitj.ac.in>
 AmanBhadkariya <140033975+AmanBhadkariya@users.noreply.github.com>
 Amisha Chhajed <136238836+amishhaa@users.noreply.github.com>
 Amit Jimiwal <amitjimiwal45@gmail.com>
+Anmol Sah <113588714+anmolsah@users.noreply.github.com>
 Annamalai Prabu <apfossdev@gmail.com>
 Anshu Kumar <132515490+anxhukumar@users.noreply.github.com>
 Anshu Kumar <contact.anshukumar@protonmail.com>
 Anudeep Sanapala <anudeep0306@gmail.com>
+Arihant Pal <arihant0pal@gmail.com>
 Aryan Bhirud <112156883+AryanBhirud@users.noreply.github.com>
+AryanJ18 <18aryanj2006@gmail.com>
 Athan Reines <kgryte@gmail.com>
+Atharva Patil <124063987+atharva-patil-23@users.noreply.github.com>
 Ayaka <73595362+USERSATOSHI@users.noreply.github.com>
 Bhavishy Agrawal <90029607+bhavishy2801@users.noreply.github.com>
 Brendan Graetz <bguiz@users.noreply.github.com>
@@ -43,6 +49,7 @@ Daniel Yu <40680511+Daniel777y@users.noreply.github.com>
 Debashis Maharana <debashismaharana7854@gmail.com>
 Deep Trivedi <128926685+thedeeppp@users.noreply.github.com>
 Deepak Singh <78257493+Deepak91168@users.noreply.github.com>
+Deepak Singh <negid0253@gmail.com>
 Desh Deepak Kant <118960904+DeshDeepakKant@users.noreply.github.com>
 Dev Goel <135586571+corsairier@users.noreply.github.com>
 Dhanyabad behera <110620935+dhanyabad11@users.noreply.github.com>
@@ -60,6 +67,7 @@ GURU PRASAD SHARMA <168292003+GURUPRASADSHARMA@users.noreply.github.com>
 Gaurav <gaurav70380@gmail.com>
 Gautam Kaushik <162317291+Kaushikgtm@users.noreply.github.com>
 Gautam sharma <gautamkrishnasharma1@gmail.com>
+GeoDaoyu <geodaoyu@foxmail.com>
 Girish Garg <garggirish2020@gmail.com>
 Golden Kumar <103646877+AuenKr@users.noreply.github.com>
 Gunj Joshi <gunjjoshi8372@gmail.com>
@@ -113,6 +121,8 @@ Momtchil Momtchev <momtchil@momtchev.com>
 Muhammad Haris <harriskhan047@outlook.com>
 Muhammad Taaha Tariq <166188821+Taaha-Tariq@users.noreply.github.com>
 Muhmmad Saad <106260977+saad-imran-dev@users.noreply.github.com>
+NEEKUorAAYUSH <aayush10072004@gmail.com>
+Nakul Krishnakumar <nakulkrishnakumar86@gmail.com>
 Naresh Jagadeesan <naresh.naresh000@gmail.com>
 Naveen Kumar <stupiddint@gmail.com>
 Neeraj Pathak <neerajrpathak710@gmail.com>
@@ -127,6 +137,7 @@ Oneday12323 <107678750+Oneday12323@users.noreply.github.com>
 Ori Miles <97595296+orimiles5@users.noreply.github.com>
 Philipp Burckhardt <pburckhardt@outlook.com>
 Pierre Forstmann <15964998+pierreforstmann@users.noreply.github.com>
+Pradyumn Prasad <pradyumnprasad.567@gmail.com>
 Prajjwal Bajpai <142303989+prajjwalbajpai@users.noreply.github.com>
 Prajwal Kulkarni <prajwalkulkarni76@gmail.com>
 Pranav Goswami <pranavchiku11@gmail.com>
@@ -162,14 +173,17 @@ Sai Avinash <120403424+nasarobot@users.noreply.github.com>
 Sai Srikar Dumpeti <80447788+the-r3aper7@users.noreply.github.com>
 Sanchay Ketan Sinha <122982233+satansin123@users.noreply.github.com>
 Sarthak Paandey <145528240+SarthakPaandey@users.noreply.github.com>
+Satyajeet Chavan <chavansatyajeet2004@gmail.com>
 Saurabh Singh <saurabhsraghuvanshi@gmail.com>
 Seyyed Parsa Neshaei <spneshaei@users.noreply.github.com>
 Shabareesh Shetty <139731143+ShabiShett07@users.noreply.github.com>
 Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 Shivam Ahir <11shivam00@gmail.com>
+Shivansh <114570926+shiv343@users.noreply.github.com>
 Shraddheya Shendre <shendreshraddheya@gmail.com>
 Shubh Mehta <93862397+Shubh942@users.noreply.github.com>
 Shubham Mishra <shubh622005@gmail.com>
+Siddhesh waje <117733253+siddhesh434@users.noreply.github.com>
 Sivam Das <100067002+Sivam2313@users.noreply.github.com>
 Snehil Shah <snehilshah.989@gmail.com>
 Soumajit Chatterjee <121816890+soumajit23@users.noreply.github.com>
@@ -189,10 +203,12 @@ Utkarsh <http://utkarsh11105@gmail.com>
 Utkarsh Raj <rajutkarsh2505@gmail.com>
 UtkershBasnet <119008923+UtkershBasnet@users.noreply.github.com>
 Vaibhav Patel <98279986+noobCoderVP@users.noreply.github.com>
+Vansh Choudhary <iamvanshchaudhary7@gmail.com>
 Vara Rahul Rajana <123227543+rajanarahul93@users.noreply.github.com>
 Varad Gupta <varadgupta21@gmail.com>
 Vinit Pandit <106718914+MeastroZI@users.noreply.github.com>
 Vivek Maurya <vm8118134@gmail.com>
+Wendy Yuchen Sun <wendyyuchensun@gmail.com>
 Xiaochuan Ye <tap91624@gmail.com>
 Yaswanth Kosuru <116426380+yaswanthkosuru@users.noreply.github.com>
 Yernar Yergaziyev <yernar.yergaziyev@erg.kz>

README.md

@@ -83,6 +83,61 @@ var v = cdiv( z1, z2 );
 // returns <Complex128>[ 5.0, 3.0 ]
 ```
 
+#### cdiv.assign( re1, im1, re2, im2, out, strideOut, offsetOut )
+
+Divides two double-precision complex floating-point numbers and assigns results to a provided output array.
+
+```javascript
+var Float64Array = require( '@stdlib/array-float64' );
+
+var out = new Float64Array( 2 );
+var v = cdiv.assign( -13.0, -1.0, -2.0, 1.0, out, 1, 0 );
+// returns <Float64Array>[ 5.0, 3.0 ]
+
+var bool = ( out === v );
+// returns true
+```
+
+The function supports the following parameters:
+
+-   **re1**: real component of the first complex number.
+-   **im1**: imaginary component of the first complex number.
+-   **re2**: real component of the second complex number.
+-   **im2**: imaginary component of the second complex number.
+-   **out**: output array.
+-   **strideOut**: stride length for `out`.
+-   **offsetOut**: starting index for `out`.
+
+#### cdiv.strided( z1, sz1, oz1, z2, sz2, oz2, out, so, oo )
+
+Divides two double-precision complex floating-point numbers stored in real-valued strided array views and assigns results to a provided strided output array.
+
+```javascript
+var Float64Array = require( '@stdlib/array-float64' );
+
+var z1 = new Float64Array( [ -13.0, -1.0 ] );
+var z2 = new Float64Array( [ -2.0, 1.0 ] );
+var out = new Float64Array( 2 );
+
+var v = cdiv.strided( z1, 1, 0, z2, 1, 0, out, 1, 0 );
+// returns <Float64Array>[ 5.0, 3.0 ]
+
+var bool = ( out === v );
+// returns true
+```
+
+The function supports the following parameters:
+
+-   **z1**: first complex number strided array view.
+-   **sz1**: stride length for `z1`.
+-   **oz1**: starting index for `z1`.
+-   **z2**: second complex number strided array view.
+-   **sz2**: stride length for `z2`.
+-   **oz2**: starting index for `z2`.
+-   **out**: output array.
+-   **so**: stride length for `out`.
+-   **oo**: starting index for `out`.
+
 </section>
 
 <!-- /.usage -->

benchmark/benchmark.assign.js

@@ -0,0 +1,70 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench-harness' );
+var uniform = require( '@stdlib/random-array-uniform' );
+var isnan = require( '@stdlib/math-base-assert-is-nan' );
+var Float64Array = require( '@stdlib/array-float64' );
+var pkg = require( './../package.json' ).name;
+var cdiv = require( './../lib' );
+
+
+// VARIABLES //
+
+var options = {
+	'dtype': 'float64'
+};
+
+
+// MAIN //
+
+bench( pkg+':assign', function benchmark( b ) {
+	var out;
+	var re;
+	var im;
+	var N;
+	var i;
+	var j;
+	var k;
+
+	N = 100;
+	re = uniform( N, -500.0, 500.0, options );
+	im = uniform( N, -500.0, 500.0, options );
+
+	out = new Float64Array( 2 );
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		j = i % N;
+		k = ( i+1 ) % N;
+		out = cdiv.assign( re[ j ], im[ j ], re[ k ], im[ k ], out, 1, 0 );
+		if ( typeof out !== 'object' ) {
+			b.fail( 'should return an object' );
+		}
+	}
+	b.toc();
+	if ( isnan( out[ 0 ] ) || isnan( out[ 1 ] ) ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});

benchmark/benchmark.strided.js

@@ -0,0 +1,68 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench-harness' );
+var uniform = require( '@stdlib/random-array-uniform' );
+var isnan = require( '@stdlib/math-base-assert-is-nan' );
+var Float64Array = require( '@stdlib/array-float64' );
+var pkg = require( './../package.json' ).name;
+var cdiv = require( './../lib' );
+
+
+// VARIABLES //
+
+var options = {
+	'dtype': 'float64'
+};
+
+
+// MAIN //
+
+bench( pkg+':strided', function benchmark( b ) {
+	var out;
+	var z1;
+	var z2;
+	var N;
+	var i;
+	var j;
+
+	N = 50;
+	z1 = uniform( N*2, -500.0, 500.0, options );
+	z2 = uniform( N*2, -500.0, 500.0, options );
+
+	out = new Float64Array( 2 );
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		j = ( i % N ) * 2;
+		out = cdiv.strided( z1, 1, j, z2, 1, j, out, 1, 0 );
+		if ( typeof out !== 'object' ) {
+			b.fail( 'should return an object' );
+		}
+	}
+	b.toc();
+	if ( isnan( out[ 0 ] ) || isnan( out[ 1 ] ) ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});