array.filter()

This function creates a new Array that returns all the values from an array that match the given filter.

array.filter( filter=function, parallel=boolean, maxThreads=number )

Returns: Array

Argument Description
filter
function, required

A function/closure that implements the following constructor

function(any arg){ return true/false;}

Alias: closure, function, callback

parallel
boolean, optional

execute closures parallel

maxThreads
number, optional

maximum number of threads executed, ignored when argument "parallel" is set to false

Alias: maxThreadCount

Examples

fruitArray = [{fruit='apple', rating=4}, {fruit='banana', rating=1}, {fruit='orange', rating=5}, {fruit='mango', rating=2}, {fruit='kiwi', rating=3}];
	favoriteFruits = fruitArray.filter(function(item){
	    return item.rating >= 3;
	});
	dump(favoriteFruits);

See also