feat: add complex/float32/base/scale

Author: ShabiShett07

lib/node_modules/@stdlib/complex/float32/base/scale/lib/assign.js

@@ -0,0 +1,54 @@
+/**
+* @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 float64ToFloat32 = require( '@stdlib/number/float64/base/to-float32' );
+
+
+// MAIN //
+
+/**
+* Scales a single-precision complex floating-point number by a real-valued single-precision floating-point scalar constant and assigns results to a provided output array.
+*
+* @param {number} alpha - scalar constant
+* @param {number} re - real component of the complex number
+* @param {number} im - imaginary component of the complex number
+* @param {Collection} out - output array
+* @param {integer} strideOut - stride length
+* @param {NonNegativeInteger} offsetOut - starting index
+* @returns {Collection} output array
+*
+* @example
+* var Float32Array = require( '@stdlib/array/float32' );
+*
+* var out = assign( 5.0, 5.0, 3.0, new Float32Array( 2 ), 1, 0 );
+* // returns <Float32Array>[ 25.0, 15.0 ]
+*/
+function assign( alpha, re, im, out, strideOut, offsetOut ) {
+	out[ offsetOut ] = float64ToFloat32( re * alpha );
+	out[ offsetOut+strideOut ] = float64ToFloat32( im * alpha );
+	return out;
+}
+
+
+// EXPORTS //
+
+module.exports = assign;

lib/node_modules/@stdlib/complex/float32/base/scale/lib/index.js

@@ -0,0 +1,63 @@
+/**
+* @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';
+
+/**
+* Scale a single-precision complex floating-point number by a real-valued single-precision floating-point scalar constant.
+*
+* @module @stdlib/complex/float32/base/scale
+*
+* @example
+* var Complex64 = require( '@stdlib/complex/float32/ctor' );
+* var real = require( '@stdlib/complex/float32/real' );
+* var imag = require( '@stdlib/complex/float32/imag' );
+* var scale = require( '@stdlib/complex/float32/base/scale' );
+*
+* var z = new Complex64( 5.0, 3.0 );
+* // returns <Complex64>
+*
+* var out = scale( scalar, z );
+* // returns <Complex64>
+*
+* var re = real( out );
+* // returns 25.0
+*
+* var im = imag( out );
+* // returns 15.0
+*/
+
+// MODULES //
+
+var setReadOnly = require( '@stdlib/utils/define-nonenumerable-read-only-property' );
+var main = require( './main.js' );
+var assign = require( './assign.js' );
+var strided = require( './strided.js' );
+
+
+// MAIN //
+
+setReadOnly( main, 'assign', assign );
+setReadOnly( main, 'strided', strided );
+
+
+// EXPORTS //
+
+module.exports = main;
+
+// exports: { "assign": "main.assign", "strided": "main.strided" }

lib/node_modules/@stdlib/complex/float32/base/scale/lib/main.js

@@ -0,0 +1,61 @@
+/**
+* @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 Complex64 = require( '@stdlib/complex/float32/ctor' );
+var real = require( '@stdlib/complex/float32/real' );
+var imag = require( '@stdlib/complex/float32/imag' );
+
+
+// MAIN //
+
+/**
+* Scales a single-precision complex floating-point number by a real-valued single-precision floating-point scalar constant.
+*
+* @param {number} alpha - scalar constant
+* @param {Complex64} z - complex number
+* @returns {Complex64} result
+*
+* @example
+* var Complex64 = require( '@stdlib/complex/float32/ctor' );
+* var real = require( '@stdlib/complex/float32/real' );
+* var imag = require( '@stdlib/complex/float32/imag' );
+*
+* var z = new Complex64( 5.0, 3.0 );
+* // returns <Complex64>
+*
+* var out = scale( 5.0, z );
+* // returns <Complex64>
+*
+* var re = real( out );
+* // returns 25.0
+*
+* var im = imag( out );
+* // returns 15.0
+*/
+function scale( alpha, z ) {
+	return new Complex64( real( z ) * alpha, imag( z ) * alpha );
+}
+
+
+// EXPORTS //
+
+module.exports = scale;

lib/node_modules/@stdlib/complex/float32/base/scale/lib/native.js

@@ -0,0 +1,62 @@
+/**
+* @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 Complex64 = require( '@stdlib/complex/float32/ctor' );
+var addon = require( './../src/addon.node' );
+
+
+// MAIN //
+
+/**
+* Scales a single-precision complex floating-point number by a real-valued single-precision floating-point scalar constant.
+*
+* @private
+* @param {number} alpha - scalar constant
+* @param {Complex64} z - complex number
+* @returns {Complex64} result
+*
+* @example
+* var Complex64 = require( '@stdlib/complex/float32/ctor' );
+* var real = require( '@stdlib/complex/float32/real' );
+* var imag = require( '@stdlib/complex/float32/imag' );
+*
+* var z = new Complex64( 5.0, 3.0 );
+* // returns <Complex64>
+*
+* var out = scale( 5.0, z );
+* // returns <Complex64>
+*
+* var re = real( out );
+* // returns 25.0
+*
+* var im = imag( out );
+* // returns 15.0
+*/
+function scale( alpha, z ) {
+	var v = addon( alpha, z );
+	return new Complex64( v.re, v.im );
+}
+
+
+// EXPORTS //
+
+module.exports = scale;