عرض مصدر PHP/array filter

<noinclude>{{DISPLAYTITLE:<code>array_filter()‎</code>}}</noinclude>
(PHP 4 >= 4.0.6, PHP 5, PHP 7)

تُرشِّح الدالة array_filter()‎ عناصر المصفوفة باستخدام دالة يحددها المستخدم.

== الوصف ==
<syntaxhighlight lang="php">
array array_filter ( array $array [, callable $callback [, int $flag = 0 ]] )
</syntaxhighlight>تمر الدالة array_filter()‎ على كل عنصر من المصفوفة array وتمرِّره كوسيط إلى الدالة callback. إذا أعادت الدالة callback القيمة true، فسيدخل العنصر الحالي من المصفوفة array إلى مصفوفة النتائج. تحافظ الدالة على المفاتيح المرتبطة بالقيم.

== المعاملات ==
array

المصفوفة التي ستعمل عليها الدالة.

callback

الدالة التي يحددها المستخدم لترشيح عناصر المصفوفة.

إذا لم تُمرر أي دالة، فستُمحى كل عناصر المصفوفة المساوية للقيمة false.

flag

تحدد المعاملات التي ستُمرر إلى الدالة callback:
* ARRAY_FILTER_USE_KEY يمرر المفتاح كمعامل وحيد إلى الدلة callback.
* ARRAY_FILTER_USE_BOTH يمرر كلًا من القيمة والمفتاح إلى الدالة callback كوسائط.

== القيم المعادة ==
تعيد المصفوفة المصفََاة.

== سجل التغييرات ==
{| class="wikitable"
|الإصدار
|الوصف
|-
|5.6.0
|إضافة المعامل الاختياري flag والثوابت ARRAY_FILTER_USE_KEY و ARRAY_FILTER_USE_BOTH
|}

== أمثلة ==
المثال 1: استخدام بسيط للدالة array_filter()‎<syntaxhighlight lang="php">
<?php

function odd($var)

{

   // تُعيد إذا كانت القيمة العددية للمتغير عددًا فرديًا

   return($var & 1);

}

function even($var)

{

   // تُعيد إذا كانت القيمة العددية للمتغير عددًا زوجيًا

   return(!($var & 1));

}

$array1 = array("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5);

$array2 = array(6, 7, 8, 9, 10, 11, 12);

echo "Odd :\n";

print_r(array_filter($array1, "odd"));

echo "Even:\n";

print_r(array_filter($array2, "even"));

?>
</syntaxhighlight>

نتيجة المثال السابق:<syntaxhighlight lang="php">
Odd :

Array

(

   [a] => 1

   [c] => 3

   [e] => 5

)

Even:

Array

(

   [0] => 6

   [2] => 8

   [4] => 10

   [6] => 12

)
</syntaxhighlight>

المثال 2: استخدام الدالة array_filter()‎ بدون استخدام دالة callback:<syntaxhighlight lang="php">
<?php

$entry = array(

            0 => 'foo',

            1 => false,

            2 => -1,

            3 => null,

            4 => ''

         );

print_r(array_filter($entry));

?>
</syntaxhighlight>

نتيجة المثال السابق:<syntaxhighlight lang="php">
Array

(

   [0] => foo

   [2] => -1

)
</syntaxhighlight>

المثال 3: استخدام الدالة array_filter()‎ مع المعامل flag:<syntaxhighlight lang="php">
<?php

$arr = ['a' => 1, 'b' => 2, 'c' => 3, 'd' => 4];

var_dump(array_filter($arr, function($k) {

   return $k == 'b';

}, ARRAY_FILTER_USE_KEY));

var_dump(array_filter($arr, function($v, $k) {

   return $k == 'b' || $v == 4;

}, ARRAY_FILTER_USE_BOTH));

?>
</syntaxhighlight>

نتيجة المثال السابق:<syntaxhighlight lang="php">
array(1) {

 ["b"]=>

 int(2)

}

array(2) {

 ["b"]=>

 int(2)

 ["d"]=>

 int(4)

}
</syntaxhighlight>

== ملاحظات ==
إذا غيرت الدالة callback في قيم المصفوفة، بإضافة العناصر أو حذفها على سبيل المثال، فإن سلوك هذه الدالة سيكون غير محددٍ.

== انظر أيضًا ==
* الدالة array_map()‎: تنفِّذ الدالة التي يحددها المستخدم على كل عنصر من عناصر المصفوفة.
* الدالة array_reduce()‎: تختزل المصفوفة إلى قيمة واحدة باستخدام دالة يحددها المستخدم.
* الدالة array_walk()‎: تُطبِّق دالةً على كل عنصر من المصفوفة.

== مصادر ==
* [http://php.net/manual/en/function.array-filter.php صفحة الدالة array_filter في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]