64 lines
1.8 KiB
Plaintext
64 lines
1.8 KiB
Plaintext
|
|
||
|
|
{{alias}}( src[, begin[, end]][, mapFcn[, thisArg]] )
|
||
|
|
Returns an iterator which iterates 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
|
||
|
|
2
|
||
|
|
> v = it.next().value
|
||
|
|
3
|
||
|
|
|
||
|
|
See Also
|
||
|
|
--------
|
||
|
|
|