@stdlib/array-to-strided-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.
 
 # Strided Iterator
 
-[![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][mdn-iterator-protocol] from a strided array-like object.
 
@@ -107,10 +107,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 ) {
@@ -174,6 +174,7 @@ var count = ctx.count;
 -   If provided a generic `array`, the returned [iterator][mdn-iterator-protocol] does **not** ignore holes. To achieve greater performance for sparse arrays, use a custom [iterator][mdn-iterator-protocol].
 -   A returned [iterator][mdn-iterator-protocol] does **not** copy a provided array-like `object`. To ensure iterable reproducibility, copy a provided array-like `object` **before** creating an [iterator][mdn-iterator-protocol]. Otherwise, any changes to the contents of an array-like `object` will be reflected in the returned [iterator][mdn-iterator-protocol].
 -   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][mdn-iterator-protocol], invoke this method directly.
+-   The returned [iterator][mdn-iterator-protocol] supports array-like objects having getter and setter accessors for array element access (e.g., [`@stdlib/array/complex64`][@stdlib/array/complex64]).
 
 </section>
 
@@ -226,6 +227,21 @@ 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>
+
+</section>
+
+<!-- /.related -->
+
 <!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
 
 
@@ -239,6 +255,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
@@ -248,7 +268,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>
 
@@ -267,9 +287,23 @@ Copyright &copy; 2016-2021. The Stdlib [Authors][stdlib-authors].
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/array-to-strided-iterator/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/array-to-strided-iterator?branch=main
 
-[dependencies-image]: https://img.shields.io/david/stdlib-js/array-to-strided-iterator
+<!--
+
+[dependencies-image]: https://img.shields.io/david/stdlib-js/array-to-strided-iterator.svg
 [dependencies-url]: https://david-dm.org/stdlib-js/array-to-strided-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-strided-iterator/tree/deno
+[umd-url]: https://github.com/stdlib-js/array-to-strided-iterator/tree/umd
+[esm-url]: https://github.com/stdlib-js/array-to-strided-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
@@ -278,6 +312,16 @@ Copyright &copy; 2016-2021. The Stdlib [Authors][stdlib-authors].
 
 [mdn-iterator-protocol]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#The_iterator_protocol
 
+[@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
+
+<!-- </related-links> -->
+
 </section>
 
 <!-- /.links -->

package/docs/types/index.d.ts

@@ -58,7 +58,7 @@ type Binary = ( value: any, index: number ) => any;
 * @param n - iteration count (zero-based)
 * @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.
@@ -80,7 +80,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 iterates over elements in an array-like object according to specified stride parameters.

package/lib/main.js

@@ -26,6 +26,7 @@ var isCollection = require( '@stdlib/assert-is-collection' );
 var isNonNegativeInteger = require( '@stdlib/assert-is-nonnegative-integer' ).isPrimitive;
 var isInteger = require( '@stdlib/assert-is-integer' ).isPrimitive;
 var iteratorSymbol = require( '@stdlib/symbol-iterator' );
+var arraylike2object = require( '@stdlib/array-base-arraylike2object' );
 
 
 // MAIN //
@@ -72,6 +73,7 @@ function stridedarray2iterator( N, src, stride, offset ) {
 	var FLG;
 	var fcn;
 	var idx;
+	var get;
 	var i;
 	if ( !isNonNegativeInteger( N ) ) {
 		throw new TypeError( 'invalid argument. First argument must be a nonnegative integer. Value: `' + N + '`.' );
@@ -108,6 +110,9 @@ function stridedarray2iterator( N, src, stride, offset ) {
 	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;
 
 	/**
@@ -124,7 +129,7 @@ function stridedarray2iterator( N, src, stride, offset ) {
 				'done': true
 			};
 		}
-		v = fcn.call( thisArg, src[ idx ], idx, i, src );
+		v = fcn.call( thisArg, get( src, idx ), idx, i, src );
 		idx += stride;
 		return {
 			'value': v,
@@ -146,7 +151,7 @@ function stridedarray2iterator( N, src, stride, offset ) {
 				'done': true
 			};
 		}
-		v = src[ idx ];
+		v = get( src, idx );
 		idx += stride;
 		return {
 			'value': v,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/array-to-strided-iterator",
-  "version": "0.0.2",
+  "version": "0.0.6",
   "description": "Create an iterator from a strided 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-strided-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/assert-is-integer": "^0.0.x",

package/CHANGELOG.md

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