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
|
{{alias}}( collection, predicate, fcn[, thisArg] )
While a test condition is true, invokes a function for each element in a
collection.
When invoked, both the predicate function and the function to apply are
provided three arguments:
- `value`: collection value
- `index`: collection index
- `collection`: the input collection
Parameters
----------
collection: Array|TypedArray|Object
Input collection over which to iterate. If provided an object, the
object must be array-like (excluding strings and functions).
predicate: Function
The predicate function which indicates whether to continue iterating
over a collection.
fcn: Function
The function to invoke for each element in a collection.
thisArg: any (optional)
Execution context for the applied function.
Returns
-------
out: Array|TypedArray|Object
Input collection.
Examples
--------
> function predicate( v ) { return v === v; };
> function logger( v, i ) { console.log( '%s: %d', i, v ); };
> var arr = [ 1, 2, 3, 4, NaN, 5 ];
> {{alias}}( arr, predicate, logger )
0: 1
1: 2
2: 3
3: 4
See Also
--------
|