@stdlib/array-to-view-iterator 0.0.5 → 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.
 
 # arrayview2iterator
 
-[![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 view.
 
@@ -177,10 +177,10 @@ v = it.next().value;
 
 The invoked function is provided four arguments:
 
--   `value`: iterated value
--   `index`: iterated value index
--   `n`: iteration count (zero-based)
--   `src`: source array-like object
+-   **value**: iterated value.
+-   **index**: iterated value index.
+-   **n**: iteration count (zero-based).
+-   **src**: source array-like object.
 
 ```javascript
 function fcn( v, i ) {
@@ -244,6 +244,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>
 
@@ -296,6 +297,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-iterator`][@stdlib/array/to-iterator]</span><span class="delimiter">: </span><span class="description">create an iterator from an array-like object.</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>
+-   <span class="package-name">[`@stdlib/array/to-view-iterator-right`][@stdlib/array/to-view-iterator-right]</span><span class="delimiter">: </span><span class="description">create an iterator from an array-like object view, iterating from right to left.</span>
+
+</section>
+
+<!-- /.related -->
+
 <!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
 
 
@@ -322,7 +340,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>
 
@@ -341,9 +359,20 @@ Copyright &copy; 2016-2021. The Stdlib [Authors][stdlib-authors].
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/array-to-view-iterator/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/array-to-view-iterator?branch=main
 
+<!--
+
 [dependencies-image]: https://img.shields.io/david/stdlib-js/array-to-view-iterator.svg
 [dependencies-url]: https://david-dm.org/stdlib-js/array-to-view-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-view-iterator/tree/deno
+[umd-url]: https://github.com/stdlib-js/array-to-view-iterator/tree/umd
+[esm-url]: https://github.com/stdlib-js/array-to-view-iterator/tree/esm
+
 [chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
 [chat-url]: https://gitter.im/stdlib-js/stdlib/
 
@@ -353,6 +382,20 @@ Copyright &copy; 2016-2021. The Stdlib [Authors][stdlib-authors].
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/array-to-view-iterator/main/LICENSE
 
+[@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-iterator]: https://www.npmjs.com/package/@stdlib/array-to-iterator
+
+[@stdlib/array/to-strided-iterator]: https://www.npmjs.com/package/@stdlib/array-to-strided-iterator
+
+[@stdlib/array/to-view-iterator-right]: https://www.npmjs.com/package/@stdlib/array-to-view-iterator-right
+
+<!-- </related-links> -->
+
 </section>
 
 <!-- /.links -->

package/docs/repl.txt

@@ -1,7 +1,7 @@
 
 {{alias}}( src[, begin[, end]][, mapFcn[, thisArg]] )
-    Returns an iterator which iterates over the elements of an array-like
-    object view.
+    Returns an iterator which iterates over the elements of an array-like object
+    view.
 
     When invoked, an input function is provided four arguments:
 

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 view.

package/lib/main.js

@@ -25,6 +25,7 @@ var isFunction = require( '@stdlib/assert-is-function' );
 var isCollection = require( '@stdlib/assert-is-collection' );
 var isInteger = require( '@stdlib/assert-is-integer' ).isPrimitive;
 var iteratorSymbol = require( '@stdlib/symbol-iterator' );
+var arraylike2object = require( '@stdlib/array-base-arraylike2object' );
 
 
 // MAIN //
@@ -63,6 +64,7 @@ function arrayview2iterator( src ) {
 	var FLG;
 	var fcn;
 	var end;
+	var get;
 	var i;
 	if ( !isCollection( src ) ) {
 		throw new TypeError( 'invalid argument. First argument must be an array-like object. Value: `' + src + '`.' );
@@ -137,6 +139,9 @@ function arrayview2iterator( 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;
 
 	/**
@@ -153,7 +158,7 @@ function arrayview2iterator( src ) {
 			};
 		}
 		return {
-			'value': fcn.call( thisArg, src[ i ], i, i-begin, src ),
+			'value': fcn.call( thisArg, get( src, i ), i, i-begin, src ),
 			'done': false
 		};
 	}
@@ -172,7 +177,7 @@ function arrayview2iterator( src ) {
 			};
 		}
 		return {
-			'value': src[ i ],
+			'value': get( src, i ),
 			'done': false
 		};
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/array-to-view-iterator",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Create an iterator from an array-like object view.",
   "license": "Apache-2.0",
   "author": {
@@ -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/assert-is-integer": "^0.0.x",