input iterator
items to prepend
iterator
var array2iterator = require( `@stdlib/array/to-iterator` );
var iter = iterUnshift( array2iterator( [ 1, 2 ] ), 3, 4 );
var v = iter.next().value;
// returns 3
v = iter.next().value;
// returns 4
v = iter.next().value;
// returns 1
v = iter.next().value;
// returns 2
var bool = iter.next().done;
// returns true
Returns an iterator which prepends values to the beginning of a provided iterator.
Notes
Symbol.iterator
and a provided iterator is iterable, the returned iterator is iterable.