46 lines
1.1 KiB
Plaintext
46 lines
1.1 KiB
Plaintext
|
|
||
|
|
{{alias}}( iterator )
|
||
|
|
Returns an iterator which iteratively computes a cumulative mid-range.
|
||
|
|
|
||
|
|
The mid-range is the arithmetic mean of maximum and minimum values.
|
||
|
|
Accordingly, the mid-range is the midpoint of the range and a measure of
|
||
|
|
central tendency.
|
||
|
|
|
||
|
|
If an environment supports Symbol.iterator, the returned iterator is
|
||
|
|
iterable.
|
||
|
|
|
||
|
|
Parameters
|
||
|
|
----------
|
||
|
|
iterator: Object
|
||
|
|
Input iterator.
|
||
|
|
|
||
|
|
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 arr = {{alias:@stdlib/array/to-iterator}}( [ 2.0, -5.0, 3.0, 5.0 ] );
|
||
|
|
> var it = {{alias}}( arr );
|
||
|
|
> var v = it.next().value
|
||
|
|
2.0
|
||
|
|
> v = it.next().value
|
||
|
|
-1.5
|
||
|
|
> v = it.next().value
|
||
|
|
-1.0
|
||
|
|
> v = it.next().value
|
||
|
|
0.0
|
||
|
|
|
||
|
|
See Also
|
||
|
|
--------
|
||
|
|
|