jQuery.grep()

jQuery.grep( array, function(elementOfArray, indexInArray), [ invert ] ) 返回: Array

描述: 查找满足过滤功能数组元素。原始数组不受影响。

  • version added: 1.0jQuery.grep( array, function(elementOfArray, indexInArray), [ invert ] )

    array该数组用来搜索。

    function(elementOfArray, indexInArray)该函数来处理每个项目的比对。第一个参数给函数是项目,第二个参数是索引。该函数应返回一个布尔值。this将是全局的窗口对象。

    invert如果“invert”为false,或没有提供,函数返回一个所有元素组成的数组对于“callback”返回true。如果“invert”为true,函数返回一个所有元素组成的数组对于“callback”返回false。

$.grep()方法删除数组必要项目,以使所有剩余项目通过提供的测试。该测试是一个函数传递一个数组项和该数组内的项目的索引。只有当测试返回true,该数组项将返回到结果数组中。

该过滤器的函数将被传递两个参数:当前数组项和它的索引。该过滤器函数必须返回'true'以包含在结果数组项。

Examples:

Example: Filters the original array of numbers leaving that are not 5 and have an index greater than 4. Then it removes all 9s.

<!DOCTYPE html>
<html>
<head>
  <style>
  div { color:blue; }
  p { color:green; margin:0; }
  span { color:red; }
  </style>
  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
  <div></div>
  <p></p>
  <span></span>
  
<script>
var arr = [ 1, 9, 3, 8, 6, 1, 5, 9, 4, 7, 3, 8, 6, 9, 1 ];
$("div").text(arr.join(", "));

arr = jQuery.grep(arr, function(n, i){
  return (n != 5 && i > 4);
});
$("p").text(arr.join(", "));

arr = jQuery.grep(arr, function (a) { return a != 9; });
$("span").text(arr.join(", "));

</script>

</body>
</html>

Demo:

Example: Filter an array of numbers to include only numbers bigger then zero.

$.grep( [0,1,2], function(n,i){
   return n > 0;
 });

Result:

[1, 2] 

Example: Filter an array of numbers to include numbers that are not bigger than zero.

$.grep( [0,1,2], function(n,i){
    return n > 0;
},true);

Result:

[0] 
jQuery 1.6 API 中文版脚本之家整理、修订 (2011年6月)