Usage

`javascript
var iterator2array = require( '@stdlib/array-from-iterator' );
`

#### iterator2array( iterator\[, out]\[, mapFcn\[, thisArg]] )

Creates (or fills) an array from an iterator.

`javascript
var randu = require( '@stdlib/random-iter-randu' );

var opts = {
'iter': 10
};

var arr = iterator2array( randu( opts ) );
// returns
`

By default, the function creates and fills a generic array. To fill an array-like object, provide an out argument.

`javascript
var Float64Array = require( '@stdlib/array-float64' );
var randu = require( '@stdlib/random-iter-randu' );

var out = new Float64Array( 10 );

var arr = iterator2array( randu(), out );
// returns

var bool = ( out === arr );
// returns true
`

To invoke a function for each iterated value, provide a callback function.

`javascript
var array2iterator = require( '@stdlib/array-to-iterator' );

function fcn( v ) {
return v * 10.0;
}

var arr = iterator2array( array2iterator( [ 1, 2, 3, 4 ] ), fcn );
// returns [ 10.0, 20.0, 30.0, 40.0 ]
`

The invoked function is provided two arguments:

- value: iterated value.
- index: iterated value index.

`javascript
var Float64Array = require( '@stdlib/array-float64' );
var randu = require( '@stdlib/random-iter-randu' );

function fcn( v, i ) {
return v * (i+1);
}

var arr = iterator2array( randu(), new Float64Array( 10 ), fcn );
// returns
`

To set the callback function execution context, provide a thisArg.

`javascript
var Float64Array = require( '@stdlib/array-float64' );
var randu = require( '@stdlib/random-iter-randu' );

function fcn( v ) {
this.count += 1;
return v * 10.0;
}

var ctx = {
'count': 0
};

var arr = iterator2array( randu(), new Float64Array( 10 ), fcn, ctx );
// returns

var count = ctx.count;
// returns 10
`