time-to-botec/squiggle/node_modules/@stdlib/array/to-view-iterator-right/docs/repl.txt

64 lines
1.8 KiB
Plaintext
Raw Normal View History

{{alias}}( src[, begin[, end]][, mapFcn[, thisArg]] )
Returns an iterator which iterates from right to left over the elements of
an array-like object view.
When invoked, an input function is provided four arguments:
- value: iterated value
- index: iterated value index
- n: iteration count (zero-based)
- src: source array-like object
If an environment supports Symbol.iterator, the returned iterator is
iterable.
If an environment supports Symbol.iterator, the function explicitly does not
not invoke an array's `@@iterator` method, regardless of whether this method
is defined. To convert an array to an implementation defined iterator,
invoke this method directly.
Parameters
----------
src: ArrayLikeObject
Array-like object from which to create the iterator.
begin: integer (optional)
Starting index (inclusive). When negative, determined relative to the
last element. Default: 0.
end: integer (optional)
Ending index (non-inclusive). When negative, determined relative to the
last element. Default: src.length.
mapFcn: Function (optional)
Function to invoke for each iterated value.
thisArg: any (optional)
Execution context.
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}}( [ 1, 2, 3, 4 ], 1, 3 );
> var v = it.next().value
3
> v = it.next().value
2
See Also
--------