Auto-generated commit

Author: stdlib-bot

.github/workflows/npm_downloads.yml

@@ -86,8 +86,8 @@ jobs:
 
       # Upload the download data:
       - name: 'Upload data'
-        # Pin action to full length commit SHA corresponding to v3.1.3
-        uses: actions/upload-artifact@a8a3f3ad30e3422c9c7b888a15615d19a852ae32
+        # Pin action to full length commit SHA
+        uses: actions/upload-artifact@5d5d22a31266ced268874388b861e4b58bb5c2f3 # v4.3.1
         with:
           # Define a name for the uploaded artifact (ensuring a unique name for each job):
           name: npm_downloads

.github/workflows/publish.yml

@@ -124,16 +124,10 @@ jobs:
               mv ./package.json.tmp ./package.json
             fi
           done
-          jq -r '.devDependencies | keys[]' ./package.json | while read -r dep; do
-            if [[ "$dep" != "@stdlib"* ]]; then
-              continue
-            fi
-            dep=$(echo "$dep" | xargs)
-            if ! find lib -name "*.js" -exec grep -q "$dep" {} + && ! grep -q -s "$dep" manifest.json && ! grep -q -s "$dep" include.gypi; then
-              jq --indent 2 "del(.devDependencies[\"$dep\"])" ./package.json > ./package.json.tmp
-              mv ./package.json.tmp ./package.json
-            fi
-          done
+
+          # Set `devDependencies` to an empty object:
+          jq --indent 2 '.devDependencies = {}' ./package.json > ./package.json.tmp
+          mv ./package.json.tmp ./package.json
 
           # Remove CLI section:
           find . -type f -name '*.md' -print0 | xargs -0 perl -0777 -i -pe "s/(\* \* \*\n+)?<section class=\"cli\">[\s\S]+?<\!\-\- \/.cli \-\->//"

.github/workflows/test_bundles.yml

@@ -168,8 +168,8 @@ jobs:
 
       # Install Deno:
       - name: 'Install Deno'
-        # Pin action to full length commit SHA corresponding to v1.1.2
-        uses: denoland/setup-deno@61fe2df320078202e33d7d5ad347e7dcfa0e8f31
+        # Pin action to full length commit SHA
+        uses: denoland/setup-deno@041b854f97b325bd60e53e9dc2de9cb9f9ac0cba # v1.1.4
         with:
           deno-version: vx.x.x
 

CONTRIBUTORS

@@ -2,6 +2,7 @@
 #
 # Contributors listed in alphabetical order.
 
+Aditya Sapra <110766802+adityacodes30@users.noreply.github.com>
 Ali Salesi <ali_sal1381@yahoo.com>
 Amit Jimiwal <amitjimiwal45@gmail.com>
 Athan Reines <kgryte@gmail.com>
@@ -13,6 +14,7 @@ Daniel Killenberger <daniel.killenberger@gmail.com>
 Dominik Moritz <domoritz@gmail.com>
 Dorrin Sotoudeh <dorrinsotoudeh123@gmail.com>
 Frank Kovacs <fran70kk@gmail.com>
+GUNJ JOSHI <gunjjoshi8372@gmail.com>
 Harshita Kalani <harshitakalani02@gmail.com>
 James Gelok <jdgelok@gmail.com>
 Jaysukh Makvana <jaysukhmakvana2004@gmail.com>
@@ -21,6 +23,7 @@ Joey Reed <joeyrreed@gmail.com>
 Jordan Gallivan <115050475+Jordan-Gallivan@users.noreply.github.com>
 Joris Labie <joris.labie1@gmail.com>
 Justin Dennison <justin1dennison@gmail.com>
+Karthik Prakash <116057817+skoriop@users.noreply.github.com>
 Marcus Fantham <mfantham@users.noreply.github.com>
 Matt Cochrane <matthew.cochrane.eng@gmail.com>
 Milan Raj <rajsite@users.noreply.github.com>
@@ -36,6 +39,7 @@ Roman Stetsyk <25715951+romanstetsyk@users.noreply.github.com>
 Ryan Seal <splrk@users.noreply.github.com>
 Seyyed Parsa Neshaei <spneshaei@users.noreply.github.com>
 Shraddheya Shendre <shendreshraddheya@gmail.com>
+Spandan Barve <114365550+marsian83@users.noreply.github.com>
 Stephannie Jiménez Gacha <steff456@hotmail.com>
 Yernar Yergaziyev <yernar.yergaziyev@erg.kz>
 orimiles5 <97595296+orimiles5@users.noreply.github.com>

README.md

@@ -1655,6 +1655,60 @@ var count = context.count;
 // returns 3
 ```
 
+<a name="method-reduce"></a>
+
+#### Complex64Array.prototype.reduce( reducerFn\[, initialValue] )
+
+Applies a provided callback function to each element of the array, in order, passing in the return value from the calculation on the preceding element and returning the accumulated result upon completion.
+
+```javascript
+var realf = require( '@stdlib/complex-realf' );
+var imagf = require( '@stdlib/complex-imagf' );
+var caddf = require( '@stdlib/math-base-ops-caddf' );
+
+var arr = new Complex64Array( 3 );
+
+arr.set( [ 1.0, 1.0 ], 0 );
+arr.set( [ 2.0, 2.0 ], 1 );
+arr.set( [ 3.0, 3.0 ], 2 );
+
+var z = arr.reduce( caddf );
+// returns <Complex64>
+
+var re = realf( z );
+// returns 6.0
+
+var im = imagf( z );
+// returns 6.0
+```
+
+The reducer function is provided four arguments:
+
+-   **acc**: accumulated result.
+-   **value**: current array element.
+-   **index**: current array element index.
+-   **arr**: the array on which this method was called.
+
+By default, the function initializes the accumulated result to the first element in the array and passes the second array element as `value` during the first invocation of the provided callback. To begin accumulation from a different starting value and pass in the first array element as `value` during the first invocation of the provided callback, provide an `initialValue` argument.
+ 
+```javascript
+var realf = require( '@stdlib/complex-realf' );
+
+function reducer( acc, v ) {
+    acc += realf( v );
+    return acc;
+}
+
+var arr = new Complex64Array( 3 );
+
+arr.set( [ 1.0, 1.0 ], 0 );
+arr.set( [ 2.0, 2.0 ], 1 );
+arr.set( [ 3.0, 3.0 ], 2 );
+
+var z = arr.reduce( reducer, 0.0 );
+// returns 6.0
+```
+
 <a name="method-reverse"></a>
 
 #### Complex64Array.prototype.reverse()
@@ -2312,8 +2366,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/array-complex64.svg
 [npm-url]: https://npmjs.org/package/@stdlib/array-complex64
 
-[test-image]: https://github.com/stdlib-js/array-complex64/actions/workflows/test.yml/badge.svg?branch=v0.2.0
-[test-url]: https://github.com/stdlib-js/array-complex64/actions/workflows/test.yml?query=branch:v0.2.0
+[test-image]: https://github.com/stdlib-js/array-complex64/actions/workflows/test.yml/badge.svg?branch=main
+[test-url]: https://github.com/stdlib-js/array-complex64/actions/workflows/test.yml?query=branch:main
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/array-complex64/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/array-complex64?branch=main

benchmark/benchmark.reduce.js

@@ -0,0 +1,52 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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 caddf = require( '@stdlib/math-base-ops-caddf' );
+var isComplexLike = require('@stdlib/assert-is-complex-like');
+var pkg = require( './../package.json' ).name;
+var Complex64Array = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg+':reduce', function benchmark( b ) {
+	var out;
+	var arr;
+	var i;
+
+	arr = new Complex64Array( [ 1, 2, 3, 4, 5, 6 ] );
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		out = arr.reduce( caddf );
+		if ( typeof out !== 'object' ) {
+			b.fail( 'should return an object' );
+		}
+	}
+	b.toc();
+	if ( !isComplexLike( out ) ) {
+		b.fail( 'should return a complex number' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});

benchmark/benchmark.reduce.length.js

@@ -0,0 +1,104 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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 pow = require( '@stdlib/math-base-special-pow' );
+var caddf = require( '@stdlib/math-base-ops-caddf' );
+var isComplexLike = require('@stdlib/assert-is-complex-like');
+var Complex64 = require( '@stdlib/complex-float32' );
+var pkg = require( './../package.json' ).name;
+var Complex64Array = require( './../lib' );
+
+
+// FUNCTIONS //
+
+/**
+* Creates a benchmark function.
+*
+* @private
+* @param {PositiveInteger} len - array length
+* @returns {Function} benchmark function
+*/
+function createBenchmark( len ) {
+	var arr;
+	var i;
+
+	arr = [];
+	for ( i = 0; i < len; i++ ) {
+		arr.push( new Complex64( i, i ) );
+	}
+	arr = new Complex64Array( arr );
+
+	return benchmark;
+
+	/**
+	* Benchmark function.
+	*
+	* @private
+	* @param {Benchmark} b - benchmark instance
+	*/
+	function benchmark( b ) {
+		var out;
+		var i;
+
+		b.tic();
+		for ( i = 0; i < b.iterations; i++ ) {
+			out = arr.reduce( caddf );
+			if ( typeof out !== 'object' ) {
+				b.fail( 'should return an object' );
+			}
+		}
+		b.toc();
+		if ( !isComplexLike( out ) ) {
+			b.fail( 'should return a complex number' );
+		}
+		b.pass( 'benchmark finished' );
+		b.end();
+	}
+}
+
+
+// MAIN //
+
+/**
+* Main execution sequence.
+*
+* @private
+*/
+function main() {
+	var len;
+	var min;
+	var max;
+	var f;
+	var i;
+
+	min = 1; // 10^min
+	max = 6; // 10^max
+
+	for ( i = min; i <= max; i++ ) {
+		len = pow( 10, i );
+		f = createBenchmark( len );
+		bench( pkg+':reduce:len='+len, f );
+	}
+}
+
+main();

dist/index.js

@@ -195,6 +195,60 @@ type TernaryMapFcn<U> = ( this: U, value: Complex64, index: number, arr: Complex
 */
 type MapFcn<U> = NullaryMapFcn<U> | UnaryMapFcn<U> | BinaryMapFcn<U> | TernaryMapFcn<U>;
 
+/**
+* Reducer function invoked for each element in an array.
+*
+* @returns accumulated result
+*/
+type NullaryReducer<U> = () => U;
+
+/**
+* Reducer function invoked for each element in an array.
+*
+* @param acc - accumulated result
+* @returns accumulated result
+*/
+type UnaryReducer<U> = ( acc: U ) => U;
+
+/**
+* Reducer function invoked for each element in an array.
+*
+* @param acc - accumulated result
+* @param value - current array element
+* @returns accumulated result
+*/
+type BinaryReducer<U> = ( acc: U, value: Complex64 ) => U;
+
+/**
+* Reducer function invoked for each element in an array.
+*
+* @param acc - accumulated result
+* @param value - current array element
+* @param index - current array element index
+* @returns accumulated result
+*/
+type TernaryReducer<U> = ( acc: U, value: Complex64, index: number ) => U;
+
+/**
+* @param acc - accumulated result
+* @param value - current array element
+* @param index - current array element index
+* @param arr - array on which the method was called
+* @returns accumulated result
+*/
+type QuaternaryReducer<U> = ( acc: U, value: Complex64, index: number, arr: Complex64Array ) => U;
+
+/**
+* Reducer function invoked for each element in an array.
+*
+* @param acc - accumulated result
+* @param value - current array element
+* @param index - current array element index
+* @param arr - array on which the method was called
+* @returns accumulated result
+*/
+type Reducer<U> = NullaryReducer<U> | UnaryReducer<U> | BinaryReducer<U> | TernaryReducer<U> | QuaternaryReducer<U>;
+
 /**
 * Class for creating a 64-bit complex number array.
 */
@@ -813,6 +867,35 @@ declare class Complex64Array implements Complex64ArrayInterface {
 	*/
 	map<U = unknown>( fcn: MapFcn<U>, thisArg?: ThisParameterType<MapFcn<U>> ): Complex64Array;
 
+	/**
+	* Applies a provided callback function to each element of the array, in order, passing in the return value from the calculation on the preceding element and returning the accumulated result upon completion.
+	*
+	* @param reducer - callback function
+	* @param initialValue - initial value
+	* @returns accumulated result
+	*
+	* @example
+	* var realf = require( '@stdlib/complex-realf' );
+	* var imagf = require( '@stdlib/complex-imagf' );
+	* var caddf = require( '@stdlib/math-base-ops-caddf' );
+	*
+	* var arr = new Complex64Array( 3 );
+	*
+	* arr.set( [ 1.0, 1.0 ], 0 );
+	* arr.set( [ 2.0, 2.0 ], 1 );
+	* arr.set( [ 3.0, 3.0 ], 2 );
+	*
+	* var z = arr.reduce( caddf );
+	* // returns <Complex64>
+	*
+	* var re = realf( z );
+	* // returns 6.0
+	*
+	* var im = imagf( z );
+	* // returns 6.0
+	*/
+	reduce<U = unknown>( reducer: Reducer<U>, initialValue?: U ): U;
+
 	/**
 	* Reverses an array in-place.
 	*

dist/index.js.map

@@ -1699,6 +1699,71 @@ setReadOnly( Complex64Array.prototype, 'map', function map( fcn, thisArg ) {
 	return out;
 });
 
+/**
+* Applies a provided callback function to each element of the array, in order, passing in the return value from the calculation on the preceding element and returning the accumulated result upon completion.
+*
+* @name reduce
+* @memberof Complex64Array.prototype
+* @type {Function}
+* @param {Function} reducer - callback function
+* @param {*} [initialValue] - initial value
+* @throws {TypeError} `this` must be a complex number array
+* @throws {TypeError} first argument must be a function
+* @throws {Error} if not provided an initial value, the array must have at least one element
+* @returns {*} accumulated result
+*
+* @example
+* var realf = require( '@stdlib/complex-realf' );
+* var imagf = require( '@stdlib/complex-imagf' );
+* var caddf = require( '@stdlib/math-base-ops-caddf' );
+*
+* var arr = new Complex64Array( 3 );
+*
+* arr.set( [ 1.0, 1.0 ], 0 );
+* arr.set( [ 2.0, 2.0 ], 1 );
+* arr.set( [ 3.0, 3.0 ], 2 );
+*
+* var z = arr.reduce( caddf );
+* // returns <Complex64>
+*
+* var re = realf( z );
+* // returns 6.0
+*
+* var im = imagf( z );
+* // returns 6.0
+*/
+setReadOnly( Complex64Array.prototype, 'reduce', function reduce( reducer, initialValue ) {
+	var buf;
+	var acc;
+	var len;
+	var v;
+	var i;
+
+	if ( !isComplexArray( this ) ) {
+		throw new TypeError( 'invalid invocation. `this` is not a complex number array.' );
+	}
+	if ( !isFunction( reducer ) ) {
+		throw new TypeError( format( 'invalid argument. First argument must be a function. Value: `%s`.', reducer ) );
+	}
+	buf = this._buffer;
+	len = this._length;
+	if ( arguments.length > 1 ) {
+		acc = initialValue;
+		i = 0;
+	} else {
+		if ( len === 0 ) {
+			throw new Error( 'invalid operation. If not provided an initial value, an array must contain at least one element.' );
+		}
+		acc = getComplex64( buf, 0 );
+		i = 1;
+	}
+	for ( ; i < len; i++ ) {
+		v = getComplex64( buf, i );
+		acc = reducer( acc, v, i, this );
+	}
+	return acc;
+});
+
 /**
 * Reverses an array in-place.
 *

docs/types/index.d.ts

@@ -41,48 +41,49 @@
     "@stdlib/array-base-assert-is-complex128array": "^0.2.0",
     "@stdlib/array-base-assert-is-complex64array": "^0.2.0",
     "@stdlib/array-base-getter": "^0.2.0",
-    "@stdlib/array-float32": "^0.2.0",
-    "@stdlib/assert-has-iterator-symbol-support": "^0.2.0",
-    "@stdlib/assert-is-array": "^0.2.0",
+    "@stdlib/array-float32": "^0.2.1",
+    "@stdlib/assert-has-iterator-symbol-support": "^0.2.1",
+    "@stdlib/assert-is-array": "^0.2.1",
     "@stdlib/assert-is-array-like-object": "^0.2.0",
-    "@stdlib/assert-is-arraybuffer": "^0.2.0",
+    "@stdlib/assert-is-arraybuffer": "^0.2.1",
     "@stdlib/assert-is-collection": "^0.2.0",
-    "@stdlib/assert-is-complex-like": "^0.2.0",
-    "@stdlib/assert-is-function": "^0.2.0",
+    "@stdlib/assert-is-complex-like": "^0.2.1",
+    "@stdlib/assert-is-function": "^0.2.1",
     "@stdlib/assert-is-nonnegative-integer": "^0.2.0",
-    "@stdlib/assert-is-object": "^0.2.0",
-    "@stdlib/assert-is-string": "^0.2.0",
-    "@stdlib/complex-float32": "^0.2.0",
-    "@stdlib/complex-imagf": "^0.2.0",
-    "@stdlib/complex-realf": "^0.2.0",
+    "@stdlib/assert-is-object": "^0.2.1",
+    "@stdlib/assert-is-string": "^0.2.1",
+    "@stdlib/complex-float32": "^0.2.1",
+    "@stdlib/complex-imagf": "^0.2.1",
+    "@stdlib/complex-realf": "^0.2.1",
     "@stdlib/math-base-assert-is-even": "^0.2.0",
     "@stdlib/math-base-assert-is-integer": "^0.2.0",
-    "@stdlib/math-base-special-floor": "^0.2.0",
-    "@stdlib/strided-base-reinterpret-complex128": "^0.2.0",
+    "@stdlib/math-base-special-floor": "^0.2.1",
+    "@stdlib/strided-base-reinterpret-complex128": "^0.2.1",
     "@stdlib/strided-base-reinterpret-complex64": "^0.2.0",
-    "@stdlib/string-format": "^0.2.0",
-    "@stdlib/symbol-iterator": "^0.2.0",
-    "@stdlib/types": "^0.3.1",
-    "@stdlib/utils-define-nonenumerable-read-only-accessor": "^0.2.0",
-    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.2.0"
+    "@stdlib/string-format": "^0.2.1",
+    "@stdlib/symbol-iterator": "^0.2.1",
+    "@stdlib/types": "^0.3.2",
+    "@stdlib/utils-define-nonenumerable-read-only-accessor": "^0.2.2",
+    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.2.1"
   },
   "devDependencies": {
     "@stdlib/array-buffer": "^0.2.0",
-    "@stdlib/array-complex128": "^0.1.0",
-    "@stdlib/assert-has-own-property": "^0.2.0",
-    "@stdlib/assert-instance-of": "^0.2.0",
-    "@stdlib/assert-is-boolean": "^0.2.0",
-    "@stdlib/assert-is-complex64": "^0.2.0",
-    "@stdlib/assert-is-complex64array": "^0.1.0",
+    "@stdlib/array-complex128": "^0.2.0",
+    "@stdlib/assert-has-own-property": "^0.2.1",
+    "@stdlib/assert-instance-of": "^0.2.1",
+    "@stdlib/assert-is-boolean": "^0.2.1",
+    "@stdlib/assert-is-complex64": "^0.2.1",
+    "@stdlib/assert-is-complex64array": "^0.2.0",
     "@stdlib/assert-is-integer": "^0.2.0",
-    "@stdlib/assert-is-negative-zero": "^0.2.0",
-    "@stdlib/assert-is-positive-zero": "^0.2.0",
-    "@stdlib/complex-imag": "^0.2.0",
-    "@stdlib/complex-real": "^0.2.0",
-    "@stdlib/console-log-each": "^0.1.0",
+    "@stdlib/assert-is-negative-zero": "^0.2.1",
+    "@stdlib/assert-is-positive-zero": "^0.2.1",
+    "@stdlib/complex-imag": "^0.2.1",
+    "@stdlib/complex-real": "^0.2.1",
+    "@stdlib/console-log-each": "^0.2.0",
+    "@stdlib/math-base-ops-caddf": "^0.2.0",
     "@stdlib/math-base-special-pow": "^0.2.0",
-    "@stdlib/random-base-randu": "^0.1.0",
-    "@stdlib/utils-identity-function": "^0.2.0",
+    "@stdlib/random-base-randu": "^0.2.0",
+    "@stdlib/utils-identity-function": "^0.2.1",
     "proxyquire": "^2.0.0",
     "tape": "git+https://github.com/kgryte/tape.git#fix/globby",
     "istanbul": "^0.4.1",

lib/main.js

@@ -0,0 +1,212 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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 tape = require( 'tape' );
+var hasOwnProp = require( '@stdlib/assert-has-own-property' );
+var isFunction = require( '@stdlib/assert-is-function' );
+var caddf = require( '@stdlib/math-base-ops-caddf' );
+var instanceOf = require( '@stdlib/assert-instance-of' );
+var realf = require( '@stdlib/complex-realf' );
+var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require('@stdlib/complex-float32');
+var Complex64Array = require( './../lib' );
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
+	t.strictEqual( typeof Complex64Array, 'function', 'main export is a function' );
+	t.end();
+});
+
+tape( 'attached to the prototype of the main export is a `reduce` method', function test( t ) {
+	t.strictEqual( hasOwnProp( Complex64Array.prototype, 'reduce' ), true, 'has property' );
+	t.strictEqual( isFunction( Complex64Array.prototype.reduce ), true, 'has method' );
+	t.end();
+});
+
+tape( 'the method throws an error if invoked with a `this` context which is not a complex number array instance', function test( t ) {
+	var values;
+	var arr;
+	var i;
+
+	arr = new Complex64Array( 5 );
+
+	values = [
+		'5',
+		5,
+		NaN,
+		true,
+		false,
+		null,
+		void 0,
+		{},
+		[],
+		function noop() {}
+	];
+	for ( i = 0; i < values.length; i++ ) {
+		t.throws( badValue( values[i] ), TypeError, 'throws an error when provided '+values[i] );
+	}
+	t.end();
+
+	function badValue( value ) {
+		return function badValue() {
+			return arr.map.reduce( value, caddf );
+		};
+	}
+});
+
+tape( 'the method throws an error if provided a first argument which is not a function', function test( t ) {
+	var values;
+	var arr;
+	var i;
+
+	arr = new Complex64Array( 10 );
+
+	values = [
+		'5',
+		3.14,
+		NaN,
+		true,
+		false,
+		null,
+		void 0,
+		{},
+		[]
+	];
+	for ( i = 0; i < values.length; i++ ) {
+		t.throws( badValue( values[i] ), TypeError, 'throws an error when provided '+values[i] );
+	}
+	t.end();
+
+	function badValue( value ) {
+		return function badValue() {
+			return arr.reduce( value );
+		};
+	}
+});
+
+tape( 'the method throws an error if not provided an initial value when operating on an empty complex number array', function test( t ) {
+	var arr;
+
+	arr = new Complex64Array( 0 );
+	t.throws( foo, Error, 'throws an error' );
+	t.end();
+
+	function foo() {
+		arr.reduce( caddf );
+	}
+});
+
+tape( 'the method uses the first element of the array as the initial value when an initial value is not provided', function test( t ) {
+	var valueArray;
+	var accArray;
+	var expected;
+	var actual;
+	var arr;
+
+	arr = new Complex64Array( [ 1.0, -1.0, 2.0, -2.0, 3.0, -3.0 ] );
+	accArray = [ 1.0, -1.0, 3.0, -3.0 ];
+	valueArray = [ 2.0, -2.0, 3.0, -3.0 ];
+	expected = new Complex64( 6.0, -6.0 );
+	actual = arr.reduce( reducer );
+
+	t.strictEqual( instanceOf( actual, Complex64 ), true, 'returns expected value' );
+	t.strictEqual( realf( actual ), realf( expected ), 'returns expected value' );
+	t.strictEqual( imagf( actual ), imagf( expected ), 'returns expected value' );
+
+	t.end();
+
+	function reducer( acc, value, index ) {
+		var ind = 2*(index-1);
+		t.strictEqual( instanceOf( acc, Complex64 ), true, 'returns expected value' );
+		t.strictEqual( realf( acc ), accArray[ ind ], 'returns expected value' );
+		t.strictEqual( imagf( acc ), accArray[ ind+1 ], 'returns expected value' );
+		t.strictEqual( instanceOf( value, Complex64 ), true, 'returns expected value' );
+		t.strictEqual( realf( value ), valueArray[ ind ], 'returns expected value' );
+		t.strictEqual( imagf( value ), valueArray[ ind+1 ], 'returns expected value' );
+		return caddf( acc, value );
+	}
+});
+
+tape( 'the method supports providing an initial value as the second argument', function test( t ) {
+	var valueArray;
+	var accArray;
+	var expected;
+	var actual;
+	var arr;
+
+	arr = new Complex64Array( [ 1.0, -1.0, 2.0, -2.0, 3.0, -3.0 ] );
+	accArray = [ 2.0, -2.0, 3.0, -3.0, 5.0, -5.0 ];
+	valueArray = [ 1.0, -1.0, 2.0, -2.0, 3.0, -3.0 ];
+	expected = new Complex64( 8.0, -8.0 );
+	actual = arr.reduce( reducer, new Complex64( 2.0, -2.0 ) );
+
+	t.strictEqual( instanceOf( actual, Complex64 ), true, 'returns expected value' );
+	t.strictEqual( realf( actual ), realf( expected ), 'returns expected value' );
+	t.strictEqual( imagf( actual ), imagf( expected ), 'returns expected value' );
+
+	t.end();
+
+	function reducer( acc, value, index ) {
+		t.strictEqual( instanceOf( acc, Complex64 ), true, 'returns expected value' );
+		t.strictEqual( realf( acc ), accArray[ 2*index ], 'returns expected value' );
+		t.strictEqual( imagf( acc ), accArray[ (2*index)+1 ], 'returns expected value' );
+		t.strictEqual( instanceOf( value, Complex64 ), true, 'returns expected value' );
+		t.strictEqual( realf( value ), valueArray[ 2*index ], 'returns expected value' );
+		t.strictEqual( imagf( value ), valueArray[ (2*index)+1 ], 'returns expected value' );
+		return caddf( acc, value );
+	}
+});
+
+tape( 'the method returns the accumulated result', function test( t ) {
+	var expected;
+	var actual;
+	var arr;
+
+	arr = new Complex64Array( [ 1.0, -1.0, 2.0, -2.0, 3.0, -3.0 ] );
+	expected = new Complex64( 6.0, -6.0 );
+	actual = arr.reduce( caddf );
+
+	t.strictEqual( instanceOf( actual, Complex64 ), true, 'returns expected value' );
+	t.strictEqual( realf( actual ), realf( expected ), 'returns expected value' );
+	t.strictEqual( imagf( actual ), imagf( expected ), 'returns expected value' );
+	t.end();
+});
+
+tape( 'the method supports returning real-valued results', function test( t ) {
+	var expected;
+	var actual;
+	var arr;
+
+	arr = new Complex64Array( [ 1.0, -1.0, 2.0, -2.0, 3.0, -3.0 ] );
+	expected = 6.0;
+	actual = arr.reduce( reducer, 0.0 );
+
+	t.strictEqual( actual, expected, 'returns expected value' );
+	t.end();
+
+	function reducer( acc, value ) {
+		return acc + realf( value );
+	}
+});