Auto-generated commit

stdlib-bot · stdlib-bot · commit 700b12b6e0b6 · 2022-01-05T09:32:39.000Z
diff --git a/README.md b/README.md
@@ -132,9 +132,9 @@ var arr = iterator2arrayview( iter, new Float64Array( 4 ), fcn );
 
 The invoked function is provided three arguments:
 
--   `value`: iterated value
--   `index`: destination index
--   `n`: iteration count (zero-based)
+-   **value**: iterated value.
+-   **index**: destination index.
+-   **n**: iteration count (zero-based).
 
 ```javascript
 var Uint8Array = require( '@stdlib/array-uint8' );
@@ -183,6 +183,7 @@ var count = ctx.count;
 ## Notes
 
 -   Iteration stops when an output array view is full **or** an iterator finishes; whichever comes first.
+-   The function supports output array-like objects having getter and setter accessors for array element access (e.g., [`@stdlib/array/complex64`][@stdlib/array/complex64]).
 
 </section>
 
@@ -306,6 +307,8 @@ Copyright &copy; 2016-2021. The Stdlib [Authors][stdlib-authors].
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/iter-to-array-view/main/LICENSE
 
+[@stdlib/array/complex64]: https://github.com/stdlib-js/array-complex64
+
 <!-- <related-links> -->
 
 [@stdlib/array/from-iterator]: https://github.com/stdlib-js/array-from-iterator
diff --git a/lib/main.js b/lib/main.js
@@ -24,6 +24,7 @@ var isFunction = require( '@stdlib/assert-is-function' );
 var isCollection = require( '@stdlib/assert-is-collection' );
 var isIteratorLike = require( '@stdlib/assert-is-iterator-like' );
 var isInteger = require( '@stdlib/assert-is-integer' ).isPrimitive;
+var arraylike2object = require( '@stdlib/array-base-arraylike2object' );
 
 
 // MAIN //
@@ -61,6 +62,7 @@ function iterator2arrayview( iterator, out ) {
 	var begin;
 	var end;
 	var fcn;
+	var set;
 	var i;
 	var v;
 
@@ -138,6 +140,7 @@ function iterator2arrayview( iterator, out ) {
 			begin = 0;
 		}
 	}
+	set = arraylike2object( out ).setter;
 	i = begin - 1;
 	if ( fcn ) {
 		while ( i < end-1 ) {
@@ -146,7 +149,7 @@ function iterator2arrayview( iterator, out ) {
 			if ( v.done ) {
 				break;
 			}
-			out[ i ] = fcn.call( thisArg, v.value, i, i-begin );
+			set( out, i, fcn.call( thisArg, v.value, i, i-begin ) );
 		}
 		return out;
 	}
@@ -156,7 +159,7 @@ function iterator2arrayview( iterator, out ) {
 		if ( v.done ) {
 			break;
 		}
-		out[ i ] = v.value;
+		set( out, i, v.value );
 	}
 	return out;
 }
diff --git a/package.json b/package.json
@@ -37,18 +37,22 @@
     "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",
     "@stdlib/assert-is-iterator-like": "^0.0.x",
     "@stdlib/types": "^0.0.x"
   },
   "devDependencies": {
+    "@stdlib/array-complex128": "^0.0.x",
     "@stdlib/array-float64": "^0.0.x",
     "@stdlib/array-to-iterator": "^0.0.x",
     "@stdlib/bench": "^0.0.x",
+    "@stdlib/complex-float64": "^0.0.x",
     "@stdlib/math-base-assert-is-nan": "^0.0.x",
     "@stdlib/random-iter-randu": "^0.0.x",
+    "@stdlib/strided-base-reinterpret-complex128": "^0.0.x",
     "@stdlib/utils-noop": "^0.0.x",
     "tape": "git+https://github.com/kgryte/tape.git#fix/globby",
     "istanbul": "^0.4.1",
diff --git a/test/test.js b/test/test.js
@@ -24,6 +24,9 @@ var tape = require( 'tape' );
 var noop = require( '@stdlib/utils-noop' );
 var randu = require( '@stdlib/random-iter-randu' );
 var Float64Array = require( '@stdlib/array-float64' );
+var Complex128Array = require( '@stdlib/array-complex128' );
+var Complex128 = require( '@stdlib/complex-float64' );
+var reinterpret128 = require( '@stdlib/strided-base-reinterpret-complex128' );
 var array2iterator = require( '@stdlib/array-to-iterator' );
 var iterator2arrayview = require( './../lib' );
 
@@ -509,6 +512,30 @@ tape( 'the function fills an array-like object with values returned from an iter
 	t.end();
 });
 
+tape( 'the function fills an array-like object with values returned from an iterator (accessors)', function test( t ) {
+	var expected;
+	var values;
+	var actual;
+	var out;
+	var it;
+
+	values = [
+		new Complex128( 1.0, 2.0 ),
+		new Complex128( 3.0, 4.0 ),
+		new Complex128( 5.0, 6.0 ),
+		new Complex128( 7.0, 8.0 )
+	];
+	it = array2iterator( values );
+
+	out = new Complex128Array( values.length );
+	actual = iterator2arrayview( it, out );
+	expected = new Float64Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
+
+	t.equal( actual, out, 'returns expected value' );
+	t.deepEqual( reinterpret128( actual, 0 ), expected, 'returns expected value' );
+	t.end();
+});
+
 tape( 'the function fills an array-like object view with values returned from an iterator (begin)', function test( t ) {
 	var expected;
 	var values;
@@ -722,6 +749,29 @@ tape( 'the function supports providing a callback to be invoked for each iterate
 	}
 });
 
+tape( 'the function supports providing a callback to be invoked for each iterated value (accessors)', function test( t ) {
+	var expected;
+	var values;
+	var actual;
+	var out;
+	var it;
+
+	values = [ 1, 2, 3, 4 ];
+	it = array2iterator( values );
+
+	out = new Complex128Array( values.length );
+	actual = iterator2arrayview( it, out, clbk );
+	expected = new Float64Array( [ 1, 0, 2, 1, 3, 2, 4, 3 ] );
+
+	t.equal( actual, out, 'returns expected value' );
+	t.deepEqual( reinterpret128( actual, 0 ), expected, 'returns expected value' );
+	t.end();
+
+	function clbk( v, i ) {
+		return new Complex128( v, i );
+	}
+});
+
 tape( 'the function supports providing a callback to be invoked for each iterated value (begin)', function test( t ) {
 	var expected;
 	var values;

Original file line number	Diff line number	Diff line change
`@@ -24,6 +24,7 @@ var isFunction = require( '@stdlib/assert-is-function' );`
`24`	`24`	`var isCollection = require( '@stdlib/assert-is-collection' );`
`25`	`25`	`var isIteratorLike = require( '@stdlib/assert-is-iterator-like' );`
`26`	`26`	`var isInteger = require( '@stdlib/assert-is-integer' ).isPrimitive;`
	`27`	`+var arraylike2object = require( '@stdlib/array-base-arraylike2object' );`
`27`	`28`
`28`	`29`
`29`	`30`	`// MAIN //`
`@@ -61,6 +62,7 @@ function iterator2arrayview( iterator, out ) {`
`61`	`62`	`var begin;`
`62`	`63`	`var end;`
`63`	`64`	`var fcn;`
	`65`	`+ var set;`
`64`	`66`	`var i;`
`65`	`67`	`var v;`
`66`	`68`
`@@ -138,6 +140,7 @@ function iterator2arrayview( iterator, out ) {`
`138`	`140`	`begin = 0;`
`139`	`141`	`}`
`140`	`142`	`}`
	`143`	`+ set = arraylike2object( out ).setter;`
`141`	`144`	`i = begin - 1;`
`142`	`145`	`if ( fcn ) {`
`143`	`146`	`while ( i < end-1 ) {`
`@@ -146,7 +149,7 @@ function iterator2arrayview( iterator, out ) {`
`146`	`149`	`if ( v.done ) {`
`147`	`150`	`break;`
`148`	`151`	`}`
`149`		`- out[ i ] = fcn.call( thisArg, v.value, i, i-begin );`
	`152`	`+ set( out, i, fcn.call( thisArg, v.value, i, i-begin ) );`
`150`	`153`	`}`
`151`	`154`	`return out;`
`152`	`155`	`}`
`@@ -156,7 +159,7 @@ function iterator2arrayview( iterator, out ) {`
`156`	`159`	`if ( v.done ) {`
`157`	`160`	`break;`
`158`	`161`	`}`
`159`		`- out[ i ] = v.value;`
	`162`	`+ set( out, i, v.value );`
`160`	`163`	`}`
`161`	`164`	`return out;`
`162`	`165`	`}`