Add support for complex number arrays

Author: kgryte

lib/node_modules/@stdlib/array/to-circular-iterator/README.md

@@ -167,10 +167,10 @@ v = it.next().value;
 
 The invoked function is provided four arguments:
 
--   `value`: iterated value
--   `index`: iterated value index
--   `n`: iteration count
--   `src`: source array-like object
+-   **value**: iterated value.
+-   **index**: iterated value index.
+-   **n**: iteration count.
+-   **src**: source array-like object.
 
 ```javascript
 function fcn( v, i ) {
@@ -234,6 +234,7 @@ var count = ctx.count;
 -   If provided a generic `array`, the returned iterator does **not** ignore holes. To achieve greater performance for sparse arrays, use a custom iterator.
 -   A returned iterator does **not** copy a provided array-like `object`. To ensure iterable reproducibility, copy a provided array-like `object` **before** creating an iterator. Otherwise, any changes to the contents of an array-like `object` will be reflected in the returned iterator.
 -   In environments supporting `Symbol.iterator`, the function **explicitly** does **not** invoke an array's `@@iterator` method, regardless of whether this method is defined. To convert an array to an implementation defined iterator, invoke this method directly.
+-   The returned iterator supports array-like objects having getter and setter accessors for array element access (e.g., [`@stdlib/array/complex64`][@stdlib/array/complex64]).
 
 </section>
 
@@ -308,6 +309,8 @@ while ( true ) {
 
 <section class="links">
 
+[@stdlib/array/complex64]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/complex64
+
 <!-- <related-links> -->
 
 [@stdlib/array/to-iterator]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/to-iterator

lib/node_modules/@stdlib/array/to-circular-iterator/docs/types/index.d.ts

@@ -73,7 +73,7 @@ type Binary = ( value: any, index: number ) => any;
 * @param n - iteration count
 * @returns iterator value
 */
-type Tertiary = ( value: any, index: number, n: number ) => any;
+type Ternary = ( value: any, index: number, n: number ) => any;
 
 /**
 * Map function invoked for each iterated value.
@@ -95,7 +95,7 @@ type Quaternary = ( value: any, index: number, n: number, src: ArrayLike<any> )
 * @param src - source array-like object
 * @returns iterator value
 */
-type MapFunction = Nullary | Unary | Binary | Tertiary | Quaternary;
+type MapFunction = Nullary | Unary | Binary | Ternary | Quaternary;
 
 /**
 * Returns an iterator which repeatedly iterates over each element in an array-like object.

lib/node_modules/@stdlib/array/to-circular-iterator/lib/main.js

@@ -27,6 +27,7 @@ var isCollection = require( '@stdlib/assert/is-collection' );
 var isObject = require( '@stdlib/assert/is-plain-object' );
 var isNonNegativeInteger = require( '@stdlib/assert/is-nonnegative-integer' ).isPrimitive;
 var iteratorSymbol = require( '@stdlib/symbol/iterator' );
+var arraylike2object = require( '@stdlib/array/base/arraylike2object' );
 
 
 // MAIN //
@@ -68,6 +69,7 @@ function circarray2iterator( src ) {
 	var iter;
 	var FLG;
 	var fcn;
+	var get;
 	var i;
 	if ( !isCollection( src ) ) {
 		throw new TypeError( 'invalid argument. First argument must be an array-like object. Value: `' + src + '`.' );
@@ -131,6 +133,9 @@ function circarray2iterator( src ) {
 	if ( iteratorSymbol ) {
 		setReadOnly( iter, iteratorSymbol, factory );
 	}
+	// Resolve an accessor for retrieving array elements (e.g., to accommodate `Complex64Array`, etc):
+	get = arraylike2object( src ).getter;
+
 	return iter;
 
 	/**
@@ -148,7 +153,7 @@ function circarray2iterator( src ) {
 			};
 		}
 		return {
-			'value': fcn.call( thisArg, src[ i ], i, count, src ),
+			'value': fcn.call( thisArg, get( src, i ), i, count, src ),
 			'done': false
 		};
 	}
@@ -171,7 +176,7 @@ function circarray2iterator( src ) {
 			};
 		}
 		return {
-			'value': fcn.call( thisArg, src[ i ], i, count, src ),
+			'value': fcn.call( thisArg, get( src, i ), i, count, src ),
 			'done': false
 		};
 	}
@@ -191,7 +196,7 @@ function circarray2iterator( src ) {
 			};
 		}
 		return {
-			'value': src[ i ],
+			'value': get( src, i ),
 			'done': false
 		};
 	}
@@ -214,7 +219,7 @@ function circarray2iterator( src ) {
 			};
 		}
 		return {
-			'value': src[ i ],
+			'value': get( src, i ),
 			'done': false
 		};
 	}