42 lines
1.0 KiB
Plaintext
42 lines
1.0 KiB
Plaintext
|
|
{{alias}}( collection, fcn[, thisArg] )
|
|
Invokes a function for each element in a collection and updates the
|
|
collection in-place.
|
|
|
|
When invoked, the input function is provided three arguments:
|
|
|
|
- `value`: collection value
|
|
- `index`: collection index
|
|
- `collection`: the input collection
|
|
|
|
Parameters
|
|
----------
|
|
collection: Array|TypedArray|Object
|
|
Input collection. If provided an object, the object must be array-like
|
|
(excluding strings and functions).
|
|
|
|
fcn: Function
|
|
Function to invoke for each element in the input collection. The
|
|
function's return value is used to update the collection in-place.
|
|
|
|
thisArg: any (optional)
|
|
Execution context.
|
|
|
|
Returns
|
|
-------
|
|
out: Array|TypedArray|Object
|
|
Input collection.
|
|
|
|
Examples
|
|
--------
|
|
> function foo( v, i ) { return v * i; };
|
|
> var arr = [ 1.0, 2.0, 3.0 ];
|
|
> var out = {{alias}}( arr, foo )
|
|
[ 0.0, 2.0, 6.0 ]
|
|
> var bool = ( out === arr )
|
|
true
|
|
|
|
See Also
|
|
--------
|
|
|