@stdlib/array-complex64 0.2.0 → 0.3.0

package/README.md

@@ -123,7 +123,7 @@ var len = arr.length;
 Creates a 64-bit complex number array from an array-like object or iterable.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 // From an array of interleaved real and imaginary components:
 var arr1 = new Complex64Array( [ 1.0, -1.0, 2.0, -2.0 ] );
@@ -283,7 +283,7 @@ var len = arr.length;
 Creates a new 64-bit complex number array from an array-like object or an iterable.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 // Create an array from interleaved real and imaginary components:
 var arr = Complex64Array.from( [ 1.0, -1.0 ] );
@@ -305,8 +305,8 @@ The iterator returned by an iterable must return either a complex number or an a
 ```javascript
 var ITERATOR_SYMBOL = require( '@stdlib/symbol-iterator' );
 var Float32Array = require( '@stdlib/array-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var iter;
 var arr;
@@ -367,9 +367,9 @@ if ( ITERATOR_SYMBOL === null ) {
 To invoke a function for each `src` value, provide a callback function. If `src` is an iterable or an array-like object containing complex numbers, the callback must return either a complex number
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function map( z ) {
     return new Complex64( realf(z)*2.0, imagf(z)*2.0 );
@@ -399,9 +399,9 @@ or an array-like object containing real and imaginary components
 
 ```javascript
 var Float32Array = require( '@stdlib/array-float32' );
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 // Return a callback which reuses allocated memory...
 function mapFcn() {
@@ -448,9 +448,9 @@ If `src` is an array-like object containing interleaved real and imaginary compo
 
 ```javascript
 var Float32Array = require( '@stdlib/array-float32' );
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function map( v ) {
     return v * 2.0;
@@ -484,9 +484,9 @@ A callback function is provided two arguments:
 To set the callback execution context, provide a `thisArg`.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function map( z ) {
     this.count += 1;
@@ -519,7 +519,7 @@ var n = ctx.count;
 Creates a new 64-bit complex number array from a variable number of arguments.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 var arr = Complex64Array.of( 1.0, -1.0, 2.0, -2.0 );
 // returns <Complex64Array>
@@ -544,8 +544,8 @@ len = arr.length;
 Returns an array element located at integer position (index) `i`, with support for both nonnegative and negative integer positions.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 10 );
 
@@ -594,9 +594,9 @@ z = arr.at( -100 );
 Copies a sequence of elements within the array starting at `start` and ending at `end` (non-inclusive) to the position starting at `target`.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 4 );
 
@@ -653,9 +653,9 @@ im = imagf( z );
 By default, `end` equals the number of array elements (i.e., one more than the last array index). To limit the sequence length, provide an `end` argument.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 4 );
 
@@ -712,9 +712,9 @@ im = imagf( z );
 When a `target`, `start`, and/or `end` index is negative, the respective index is determined relative to the last array element. The following example achieves the same behavior as the previous example:
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 4 );
 
@@ -775,9 +775,9 @@ im = imagf( z );
 Returns an iterator for iterating over array key-value pairs.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = [
     new Complex64( 1.0, -1.0 ),
@@ -821,6 +821,11 @@ var bool = it.next().done;
 // returns true
 ```
 
+The returned [iterator][mdn-iterator-protocol] protocol-compliant object has the following properties:
+
+-   **next**: function which returns an [iterator][mdn-iterator-protocol] protocol-compliant object containing the next iterated value (if one exists) assigned to a `value` property and a `done` property having a `boolean` value indicating whether the [iterator][mdn-iterator-protocol] is finished.
+-   **return**: function which closes an [iterator][mdn-iterator-protocol] and returns a single (optional) argument in an [iterator][mdn-iterator-protocol] protocol-compliant object.
+
 <a name="method-every"></a>
 
 #### Complex64Array.prototype.every( predicate\[, thisArg] )
@@ -828,8 +833,8 @@ var bool = it.next().done;
 Returns a boolean indicating whether all elements pass a test.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v ) {
     return ( realf( v ) === imagf( v ) );
@@ -886,9 +891,9 @@ var count = context.count;
 Returns a modified typed array filled with a fill value.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 3 );
 
@@ -959,9 +964,9 @@ im = imagf( z );
 When a `start` and/or `end` index is negative, the respective index is determined relative to the last array element.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 3 );
 
@@ -994,8 +999,8 @@ im = imagf( z );
 Returns a new array containing the elements of an array which pass a test implemented by a predicate function.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v ) {
     return ( realf( v ) === imagf( v ) );
@@ -1033,8 +1038,8 @@ The `predicate` function is provided three arguments:
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v, i ) {
     this.count += 1;
@@ -1069,9 +1074,9 @@ var count = context.count;
 Returns the first element in an array for which a predicate function returns a truthy value.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
-var Complex64 = require( '@stdlib/complex-float32' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 function predicate( v ) {
     return ( realf( v ) === imagf( v ) );
@@ -1103,8 +1108,8 @@ The `predicate` function is provided three arguments:
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v, i ) {
     this.count += 1;
@@ -1142,8 +1147,8 @@ var count = context.count;
 Returns the index of the first element in an array for which a predicate function returns a truthy value.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v ) {
     return ( realf( v ) === imagf( v ) );
@@ -1169,8 +1174,8 @@ The `predicate` function is provided three arguments:
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v, i ) {
     this.count += 1;
@@ -1202,9 +1207,9 @@ var count = context.count;
 Returns the last element in an array for which a predicate function returns a truthy value.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
-var Complex64 = require( '@stdlib/complex-float32' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 function predicate( v ) {
     return ( realf( v ) === imagf( v ) );
@@ -1236,8 +1241,8 @@ The `predicate` function is provided three arguments:
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v, i ) {
     this.count += 1;
@@ -1275,8 +1280,8 @@ var count = context.count;
 Returns the index of the last element in an array for which a predicate function returns a truthy value.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v ) {
     return ( realf( v ) === imagf( v ) );
@@ -1302,8 +1307,8 @@ The `predicate` function is provided three arguments:
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v, i ) {
     this.count += 1;
@@ -1335,7 +1340,7 @@ var count = context.count;
 Invokes a function once for each array element.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 function log( v, i ) {
     console.log( '%s: %s', i, v.toString() );
@@ -1365,7 +1370,7 @@ The invoked function is provided three arguments:
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 function fcn( v, i ) {
     this.count += 1;
@@ -1401,8 +1406,8 @@ var count = context.count;
 Returns an array element located at a nonnegative integer position (index) `i`.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 10 );
 
@@ -1436,7 +1441,7 @@ var z = arr.get( 100 );
 Returns a boolean indicating whether an array includes a provided value.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 var arr = new Complex64Array( 5 );
 
@@ -1463,7 +1468,7 @@ bool = arr.includes( new Complex64( 4.0, -4.0 ), -3 );
 Returns the first index at which a given element can be found.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 var arr = new Complex64Array( 5 );
 
@@ -1486,7 +1491,7 @@ idx = arr.indexOf( new Complex64( 4.0, -4.0 ), -3 );
 If `searchElement` is not present in the array, the method returns `-1`.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 var arr = new Complex64Array( 10 );
 
@@ -1530,6 +1535,35 @@ var str = arr.join( '/' );
 // returns '1 + 1i/2 - 2i/3 + 3i'
 ```
 
+<a name="method-keys"></a>
+
+#### Complex64Array.prototype.keys()
+
+Returns an iterator for iterating over each index key in a typed array.
+
+```javascript
+var arr = new Complex64Array( 2 );
+
+arr.set( [ 1.0, -1.0 ], 0 );
+arr.set( [ 2.0, -2.0 ], 1 );
+
+var iter = arr.keys();
+
+var v = iter.next().value;
+// returns 0
+
+v = iter.next().value;
+// returns 1
+
+var bool = iter.next().done;
+// returns true
+```
+
+The returned [iterator][mdn-iterator-protocol] protocol-compliant object has the following properties:
+
+-   **next**: function which returns an [iterator][mdn-iterator-protocol] protocol-compliant object containing the next iterated value (if one exists) assigned to a `value` property and a `done` property having a `boolean` value indicating whether the [iterator][mdn-iterator-protocol] is finished.
+-   **return**: function which closes an [iterator][mdn-iterator-protocol] and returns a single (optional) argument in an [iterator][mdn-iterator-protocol] protocol-compliant object.
+
 <a name="method-last-index-of"></a>
 
 #### Complex64Array.prototype.lastIndexOf( searchElement\[, fromIndex] )
@@ -1537,7 +1571,7 @@ var str = arr.join( '/' );
 Returns the last index at which a given element can be found.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 var arr = new Complex64Array( 5 );
 
@@ -1560,7 +1594,7 @@ idx = arr.lastIndexOf( new Complex64( 4.0, -4.0 ), -1 );
 If `searchElement` is not present in the array, the method returns `-1`.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 var arr = new Complex64Array( 10 );
 
@@ -1581,9 +1615,9 @@ idx = arr.lastIndexOf( new Complex64( 2.0, -2.0 ), 0 );
 Returns a new array with each element being the result of a provided callback function.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function scale( v ) {
     return new Complex64( 2.0*realf( v ), 2.0*imagf( v ) );
@@ -1618,9 +1652,9 @@ The callback function is provided three arguments:
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function scale( v ) {
     this.count += 1;
@@ -1645,6 +1679,114 @@ 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-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+var caddf = require( '@stdlib/complex-float32-base-add' );
+
+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-float32-real' );
+
+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-reduce-right"></a>
+
+#### Complex64Array.prototype.reduceRight( reducerFn\[, initialValue] )
+
+Applies a provided callback function to each element of the array, in reverse order, passing in the return value from the calculation on the following element and returning the accumulated result upon completion.
+
+```javascript
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+var caddf = require( '@stdlib/complex-float32-base-add' );
+
+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.reduceRight( 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 last element in the array and passes the second-last array element as `value` during the first invocation of the provided callback. To begin accumulation from a different starting value and pass in the last array element as `value` during the first invocation of the provided callback, provide an `initialValue` argument.
+
+```javascript
+var realf = require( '@stdlib/complex-float32-real' );
+
+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.reduceRight( reducer, 0.0 );
+// returns 6.0
+```
+
 <a name="method-reverse"></a>
 
 #### Complex64Array.prototype.reverse()
@@ -1652,8 +1794,8 @@ var count = context.count;
 Reverses an array in-place.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 3 );
 
@@ -1699,9 +1841,9 @@ im = imagf( z );
 Sets one or more array elements.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 10 );
 
@@ -1732,9 +1874,9 @@ im = imagf( z );
 By default, the method sets array elements starting at position (index) `i = 0`. To set elements starting elsewhere in the array, provide an index argument `i`.
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 10 );
 
@@ -1765,9 +1907,9 @@ im = imagf( z );
 In addition to providing a complex number, to set one or more array elements, provide an array-like object containing either complex numbers
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 10 );
 
@@ -1796,8 +1938,8 @@ or interleaved real and imaginary components
 
 ```javascript
 var Float32Array = require( '@stdlib/array-float32' );
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 10 );
 
@@ -1831,8 +1973,8 @@ A few notes:
 Copies a portion of a typed array to a new typed array.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 
@@ -1864,8 +2006,8 @@ im = imagf( z );
 By default, the method returns a typed array beginning with the first array element. To specify an alternative array index at which to begin, provide a `start` index (inclusive).
 
 ```javascript
-var imagf = require( '@stdlib/complex-imagf' );
-var realf = require( '@stdlib/complex-realf' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+var realf = require( '@stdlib/complex-float32-real' );
 
 var arr = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 
@@ -1888,8 +2030,8 @@ var im = imagf( z );
 By default, the method returns a typed array which includes all array elements after `start`. To limit the number of array elements after `start`, provide an `end` index (exclusive).
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 
@@ -1925,8 +2067,8 @@ im = imagf( z );
 Returns a boolean indicating whether at least one element passes a test.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v ) {
     return ( realf( v ) === imagf( v ) );
@@ -1953,8 +2095,8 @@ The `predicate` function is provided three arguments:
 To set the function execution context, provide a `thisArg`.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 function predicate( v, i ) {
     this.count += 1;
@@ -1979,6 +2121,90 @@ var count = context.count;
 // returns 2
 ```
 
+<a name="method-sort"></a>
+
+#### Complex64Array.prototype.sort( compareFcn )
+
+Sorts an array in-place.
+
+```javascript
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+
+function compare( a, b ) {
+    var re1;
+    var re2;
+    var im1;
+    var im2;
+    re1 = realf( a );
+    re2 = realf( b );
+    if ( re1 < re2 ) {
+        return -1;
+    }
+    if ( re1 > re2 ) {
+        return 1;
+    }
+    im1 = imagf( a );
+    im2 = imagf( b );
+    if ( im1 < im2 ) {
+        return -1;
+    }
+    if ( im1 > im2 ) {
+        return 1;
+    }
+    return 0;
+}
+
+var arr = new Complex64Array( 3 );
+
+arr.set( [ 3.0, -3.0 ], 0 );
+arr.set( [ 1.0, -1.0 ], 1 );
+arr.set( [ 2.0, -2.0 ], 2 );
+
+var out = arr.sort( compare );
+// returns <Complex64Array>
+
+var z = out.get( 0 );
+// returns <Complex64>
+
+var re = realf( z );
+// returns 1.0
+
+var im = imagf( z );
+// returns -1.0
+
+z = out.get( 1 );
+// returns <Complex64>
+
+re = realf( z );
+// returns 2.0
+
+im = imagf( z );
+// returns -2.0
+
+z = out.get( 2 );
+// returns <Complex64>
+
+re = realf( z );
+// returns 3.0
+
+im = imagf( z );
+// returns -3.0
+```
+
+The `compareFcn` determines the order of the elements. The function is called with the following arguments:
+
+-   **a**: the first element for comparison.
+-   **b**: the second element for comparison.
+
+The function should return a number where:
+
+-   a negative value indicates that `a` should come before `b`.
+-   a positive value indicates that `a` should come after `b`.
+-   zero or `NaN` indicates that `a` and `b` are considered equal.
+
+In contrast to real numbers, one cannot define a default order relation which is compatible with multiplication. Accordingly, users **must** explicitly provide a `compareFcn` argument and are thus responsible for specifying a complex number ordering.
+
 <a name="method-subarray"></a>
 
 #### Complex64Array.prototype.subarray( \[begin\[, end]] )
@@ -1986,8 +2212,8 @@ var count = context.count;
 Creates a new typed array view over the same underlying [`ArrayBuffer`][@stdlib/array/buffer] and with the same underlying data type as the host array.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 
@@ -2019,8 +2245,8 @@ im = imagf( z );
 By default, the method creates a typed array view beginning with the first array element. To specify an alternative array index at which to begin, provide a `begin` index (inclusive).
 
 ```javascript
-var imagf = require( '@stdlib/complex-imagf' );
-var realf = require( '@stdlib/complex-realf' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+var realf = require( '@stdlib/complex-float32-real' );
 
 var arr = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 
@@ -2043,8 +2269,8 @@ var im = imagf( z );
 By default, the method creates a typed array view which includes all array elements after `begin`. To limit the number of array elements after `begin`, provide an `end` index (exclusive).
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 
@@ -2073,6 +2299,27 @@ im = imagf( z );
 // returns 6.0
 ```
 
+<a name="method-to-locale-string"></a>
+
+#### Complex64Array.prototype.toLocaleString( \[locales\[, options]] )
+
+Serializes an array as a locale-specific string.
+
+```javascript
+var arr = new Complex64Array( 2 );
+
+arr.set( [ 1.0, 1.0 ], 0 );
+arr.set( [ 2.0, 2.0 ], 1 );
+
+var str = arr.toLocaleString();
+// returns '1 + 1i,2 + 2i'
+```
+
+The method supports the following arguments:
+
+-   **locales**: a string with a BCP 47 language tag or an array of such strings.
+-   **options**: configuration properties.
+
 <a name="method-to-reversed"></a>
 
 #### Complex64Array.prototype.toReversed()
@@ -2080,8 +2327,8 @@ im = imagf( z );
 Returns a new typed array containing the elements in reversed order.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
 
 var arr = new Complex64Array( 3 );
 
@@ -2120,6 +2367,90 @@ im = imagf( z );
 // returns 1.0
 ```
 
+<a name="method-to-sorted"></a>
+
+#### Complex64Array.prototype.toSorted( compareFcn )
+
+Returns a new typed array containing the elements in sorted order.
+
+```javascript
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+
+function compare( a, b ) {
+    var re1;
+    var re2;
+    var im1;
+    var im2;
+    re1 = realf( a );
+    re2 = realf( b );
+    if ( re1 < re2 ) {
+        return -1;
+    }
+    if ( re1 > re2 ) {
+        return 1;
+    }
+    im1 = imagf( a );
+    im2 = imagf( b );
+    if ( im1 < im2 ) {
+        return -1;
+    }
+    if ( im1 > im2 ) {
+        return 1;
+    }
+    return 0;
+}
+
+var arr = new Complex64Array( 3 );
+
+arr.set( [ 3.0, -3.0 ], 0 );
+arr.set( [ 1.0, -1.0 ], 1 );
+arr.set( [ 2.0, -2.0 ], 2 );
+
+var out = arr.toSorted( compare );
+// returns <Complex64Array>
+
+var z = out.get( 0 );
+// returns <Complex64>
+
+var re = realf( z );
+// returns 1.0
+
+var im = imagf( z );
+// returns -1.0
+
+z = out.get( 1 );
+// returns <Complex64>
+
+re = realf( z );
+// returns 2.0
+
+im = imagf( z );
+// returns -2.0
+
+z = out.get( 2 );
+// returns <Complex64>
+
+re = realf( z );
+// returns 3.0
+
+im = imagf( z );
+// returns -3.0
+```
+
+The `compareFcn` determines the order of the elements. The function is called with the following arguments:
+
+-   **a**: the first element for comparison.
+-   **b**: the second element for comparison.
+
+The function should return a number where:
+
+-   a negative value indicates that `a` should come before `b`.
+-   a positive value indicates that `a` should come after `b`.
+-   zero or `NaN` indicates that `a` and `b` are considered equal.
+
+In contrast to real numbers, one cannot define a default order relation which is compatible with multiplication. Accordingly, users **must** explicitly provide a `compareFcn` argument and are thus responsible for specifying a complex number ordering.
+
 <a name="method-to-string"></a>
 
 #### Complex64Array.prototype.toString()
@@ -2137,16 +2468,59 @@ var str = arr.toString();
 // returns '1 + 1i,2 - 2i,3 + 3i'
 ```
 
+<a name="method-values"></a>
+
+#### Complex64Array.prototype.values()
+
+Returns an iterator for iterating over each value in a typed array.
+
+```javascript
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+var arr = new Complex64Array( 2 );
+
+arr.set( [ 1.0, -1.0 ], 0 );
+arr.set( [ 2.0, -2.0 ], 1 );
+
+var iter = arr.values();
+
+var v = iter.next().value;
+// returns <Complex64>
+
+var re = realf( v );
+// returns 1.0
+
+var im = imagf( v );
+// returns -1.0
+
+v = iter.next().value;
+// returns <Complex64>
+
+re = realf( v );
+// returns 2.0
+
+im = imagf( v );
+// returns -2.0
+
+var bool = iter.next().done;
+// returns true
+```
+
+The returned [iterator][mdn-iterator-protocol] protocol-compliant object has the following properties:
+
+-   **next**: function which returns an [iterator][mdn-iterator-protocol] protocol-compliant object containing the next iterated value (if one exists) assigned to a `value` property and a `done` property having a `boolean` value indicating whether the [iterator][mdn-iterator-protocol] is finished.
+-   **return**: function which closes an [iterator][mdn-iterator-protocol] and returns a single (optional) argument in an [iterator][mdn-iterator-protocol] protocol-compliant object.
+
 <a name="method-with"></a>
 
-#### Complex128Array.prototype.with( index, value )
+#### Complex64Array.prototype.with( index, value )
 
 Returns a new typed array with the element at a provided index replaced with a provided value.
 
 ```javascript
-var realf = require( '@stdlib/complex-realf' );
-var imagf = require( '@stdlib/complex-imagf' );
-var Complex64 = require( '@stdlib/complex-float32' );
+var realf = require( '@stdlib/complex-float32-real' );
+var imagf = require( '@stdlib/complex-float32-imag' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 
 var arr = new Complex64Array( 3 );
 
@@ -2201,7 +2575,7 @@ var im = imagf( z );
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
+var Complex64 = require( '@stdlib/complex-float32-ctor' );
 var Float32Array = require( '@stdlib/array-float32' );
 var logEach = require( '@stdlib/console-log-each' );
 var Complex64Array = require( '@stdlib/array-complex64' );
@@ -2257,7 +2631,7 @@ logEach( '%s', out );
 
 -   <span class="package-name">[`@stdlib/array-complex128`][@stdlib/array/complex128]</span><span class="delimiter">: </span><span class="description">Complex128Array.</span>
 -   <span class="package-name">[`@stdlib/complex-cmplx`][@stdlib/complex/cmplx]</span><span class="delimiter">: </span><span class="description">create a complex number.</span>
--   <span class="package-name">[`@stdlib/complex-float32`][@stdlib/complex/float32]</span><span class="delimiter">: </span><span class="description">64-bit complex number.</span>
+-   <span class="package-name">[`@stdlib/complex-float32/ctor`][@stdlib/complex/float32/ctor]</span><span class="delimiter">: </span><span class="description">64-bit complex number.</span>
 
 </section>
 
@@ -2302,8 +2676,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=v0.3.0
+[test-url]: https://github.com/stdlib-js/array-complex64/actions/workflows/test.yml?query=branch:v0.3.0
 
 [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
@@ -2335,11 +2709,13 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/array-complex64/main/LICENSE
 
+[mdn-iterator-protocol]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#The_iterator_protocol
+
 [@stdlib/array/typed]: https://www.npmjs.com/package/@stdlib/array-typed
 
 [@stdlib/array/buffer]: https://www.npmjs.com/package/@stdlib/array-buffer
 
-[@stdlib/complex/float32]: https://www.npmjs.com/package/@stdlib/complex-float32
+[@stdlib/complex/float32/ctor]: https://www.npmjs.com/package/@stdlib/complex-float32-ctor
 
 <!-- <related-links> -->