@stdlib/array-to-iterator 0.0.2 → 0.0.6

package/NOTICE

@@ -1 +1 @@
-Copyright (c) 2016-2021 The Stdlib Authors.
+Copyright (c) 2016-2022 The Stdlib Authors.

package/README.md

@@ -20,7 +20,7 @@ limitations under the License.
 
 # array2iterator
 
-[![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] [![dependencies][dependencies-image]][dependencies-url]
+[![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
 
 > Create an iterator from an array-like object.
 
@@ -101,9 +101,9 @@ v = it.next().value;
 
 The invoked function is provided three arguments:
 
--   `value`: iterated value
--   `index`: iterated value index
--   `src`: source array-like object
+-   **value**: iterated value.
+-   **index**: iterated value index.
+-   **src**: source array-like object.
 
 ```javascript
 function fcn( v, i ) {
@@ -167,6 +167,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 [`@stdlib/array/to-sparse-iterator`][@stdlib/array/to-sparse-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>
 
@@ -219,6 +220,23 @@ while ( true ) {
 
 <!-- /.references -->
 
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/array/from-iterator`][@stdlib/array/from-iterator]</span><span class="delimiter">: </span><span class="description">create (or fill) an array from an iterator.</span>
+-   <span class="package-name">[`@stdlib/array/to-circular-iterator`][@stdlib/array/to-circular-iterator]</span><span class="delimiter">: </span><span class="description">create an iterator which repeatedly iterates over the elements of an array-like object.</span>
+-   <span class="package-name">[`@stdlib/array/to-iterator-right`][@stdlib/array/to-iterator-right]</span><span class="delimiter">: </span><span class="description">create an iterator from an array-like object, iterating from right to left.</span>
+-   <span class="package-name">[`@stdlib/array/to-strided-iterator`][@stdlib/array/to-strided-iterator]</span><span class="delimiter">: </span><span class="description">create an iterator from a strided array-like object.</span>
+
+</section>
+
+<!-- /.related -->
+
 <!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
 
 
@@ -232,6 +250,10 @@ This package is part of [stdlib][stdlib], a standard library for JavaScript and
 
 For more information on the project, filing bug reports and feature requests, and guidance on how to develop [stdlib][stdlib], see the main project [repository][stdlib].
 
+#### Community
+
+[![Chat][chat-image]][chat-url]
+
 ---
 
 ## License
@@ -241,7 +263,7 @@ See [LICENSE][stdlib-license].
 
 ## Copyright
 
-Copyright &copy; 2016-2021. The Stdlib [Authors][stdlib-authors].
+Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
 
 </section>
 
@@ -260,16 +282,44 @@ Copyright &copy; 2016-2021. The Stdlib [Authors][stdlib-authors].
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/array-to-iterator/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/array-to-iterator?branch=main
 
-[dependencies-image]: https://img.shields.io/david/stdlib-js/array-to-iterator
+<!--
+
+[dependencies-image]: https://img.shields.io/david/stdlib-js/array-to-iterator.svg
 [dependencies-url]: https://david-dm.org/stdlib-js/array-to-iterator/main
 
+-->
+
+[umd]: https://github.com/umdjs/umd
+[es-module]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules
+
+[deno-url]: https://github.com/stdlib-js/array-to-iterator/tree/deno
+[umd-url]: https://github.com/stdlib-js/array-to-iterator/tree/umd
+[esm-url]: https://github.com/stdlib-js/array-to-iterator/tree/esm
+
+[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
+[chat-url]: https://gitter.im/stdlib-js/stdlib/
+
 [stdlib]: https://github.com/stdlib-js/stdlib
 
 [stdlib-authors]: https://github.com/stdlib-js/stdlib/graphs/contributors
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/array-to-iterator/main/LICENSE
 
-[@stdlib/array/to-sparse-iterator]: https://github.com/stdlib-js/array-to-sparse-iterator
+[@stdlib/array/to-sparse-iterator]: https://www.npmjs.com/package/@stdlib/array-to-sparse-iterator
+
+[@stdlib/array/complex64]: https://www.npmjs.com/package/@stdlib/array-complex64
+
+<!-- <related-links> -->
+
+[@stdlib/array/from-iterator]: https://www.npmjs.com/package/@stdlib/array-from-iterator
+
+[@stdlib/array/to-circular-iterator]: https://www.npmjs.com/package/@stdlib/array-to-circular-iterator
+
+[@stdlib/array/to-iterator-right]: https://www.npmjs.com/package/@stdlib/array-to-iterator-right
+
+[@stdlib/array/to-strided-iterator]: https://www.npmjs.com/package/@stdlib/array-to-strided-iterator
+
+<!-- </related-links> -->
 
 </section>
 

package/docs/types/index.d.ts

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

package/lib/main.js

@@ -24,6 +24,7 @@ var setReadOnly = require( '@stdlib/utils-define-nonenumerable-read-only-propert
 var isFunction = require( '@stdlib/assert-is-function' );
 var isCollection = require( '@stdlib/assert-is-collection' );
 var iteratorSymbol = require( '@stdlib/symbol-iterator' );
+var arraylike2object = require( '@stdlib/array-base-arraylike2object' );
 
 
 // MAIN //
@@ -57,6 +58,7 @@ function array2iterator( 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 + '`.' );
@@ -83,6 +85,9 @@ function array2iterator( 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;
 
 	/**
@@ -99,7 +104,7 @@ function array2iterator( src ) {
 			};
 		}
 		return {
-			'value': fcn.call( thisArg, src[ i ], i, src ),
+			'value': fcn.call( thisArg, get( src, i ), i, src ),
 			'done': false
 		};
 	}
@@ -118,7 +123,7 @@ function array2iterator( src ) {
 			};
 		}
 		return {
-			'value': src[ i ],
+			'value': get( src, i ),
 			'done': false
 		};
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/array-to-iterator",
-  "version": "0.0.2",
+  "version": "0.0.6",
   "description": "Create an iterator from an array-like object.",
   "license": "Apache-2.0",
   "author": {
@@ -28,7 +28,7 @@
     "examples": "make examples",
     "benchmark": "make benchmark"
   },
-  "homepage": "https://github.com/stdlib-js/stdlib",
+  "homepage": "https://stdlib.io",
   "repository": {
     "type": "git",
     "url": "git://github.com/stdlib-js/array-to-iterator.git"
@@ -37,6 +37,7 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
+    "@stdlib/array-base-arraylike2object": "^0.0.x",
     "@stdlib/assert-is-collection": "^0.0.x",
     "@stdlib/assert-is-function": "^0.0.x",
     "@stdlib/symbol-iterator": "^0.0.x",
@@ -44,9 +45,13 @@
     "@stdlib/utils-define-nonenumerable-read-only-property": "^0.0.x"
   },
   "devDependencies": {
+    "@stdlib/array-complex64": "^0.0.x",
     "@stdlib/array-float64": "^0.0.x",
     "@stdlib/assert-is-iterator-like": "^0.0.x",
     "@stdlib/bench": "^0.0.x",
+    "@stdlib/complex-float32": "^0.0.x",
+    "@stdlib/complex-imagf": "^0.0.x",
+    "@stdlib/complex-realf": "^0.0.x",
     "@stdlib/math-base-assert-is-nan": "^0.0.x",
     "@stdlib/random-base-randu": "^0.0.x",
     "@stdlib/utils-inmap": "^0.0.x",

package/CHANGELOG.md

@@ -1,5 +0,0 @@
-# CHANGELOG
-
-> Package changelog.
-
-See [GitHub Releases](https://github.com/stdlib-js/array-to-iterator/releases) for the changelog.