1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51
|
{{alias}}( iterator, fcn[, options] )
Returns an iterator which invokes a unary function accepting a single
numeric argument for each iterated value.
When invoked, the input function is provided one argument:
- value: iterated value
If an environment supports Symbol.iterator and a provided iterator is
iterable, the returned iterator is iterable.
Parameters
----------
iterator: Object
Input iterator.
fcn: Function
Function to invoke for each iterated value.
options: Object (optional)
Options.
options.invalid: any (optional)
Return value when an input iterator yields a non-numeric value. Default:
NaN.
Returns
-------
iterator: Object
Iterator.
iterator.next(): Function
Returns an iterator protocol-compliant object containing the next
iterated value (if one exists) and a boolean flag indicating whether the
iterator is finished.
iterator.return( [value] ): Function
Finishes an iterator and returns a provided value.
Examples
--------
> var it = {{alias}}( {{alias:@stdlib/random/iter/randu}}(), {{alias:@stdlib/math/base/special/sin}} );
> var r = it.next().value
<number>
> r = it.next().value
<number>
See Also
--------
|