{{alias}}( arr, [options,] clbk ) Finds elements in an array-like object that satisfy a test condition. Parameters ---------- arr: Array|TypedArray|string Object from which elements will be tested. options: Object (optional) Options. options.k: integer (optional) Limits the number of returned elements. The sign determines the direction in which to search. If set to a negative integer, the function searches from last element to first element. Default: arr.length. options.returns: string (optional) If `values`, values are returned; if `indices`, indices are returned; if `*`, both indices and values are returned. Default: 'indices'. clbk: Function Function invoked for each array element. If the return value is truthy, the value is considered to have satisfied the test condition. Returns ------- out: Array Array of indices, element values, or arrays of index-value pairs. Examples -------- > var data = [ 30, 20, 50, 60, 10 ]; > function condition( val ) { return val > 20; }; > var vals = {{alias}}( data, condition ) [ 0, 2, 3 ] // Limit number of results: > data = [ 30, 20, 50, 60, 10 ]; > var opts = { 'k': 2, 'returns': 'values' }; > vals = {{alias}}( data, opts, condition ) [ 30, 50 ] // Return both indices and values as index-value pairs: > data = [ 30, 20, 50, 60, 10 ]; > opts = { 'k': -2, 'returns': '*' }; > vals = {{alias}}( data, opts, condition ) [ [ 3, 60 ], [ 2, 50 ] ] See Also --------