عرض مصدر PHP/preg filter

<noinclude>{{DISPLAYTITLE:الدالة <code>preg_filter()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في PHP}}</noinclude>
(PHP 5 >= 5.3.0, PHP 7)

تبحث الدالة <code>preg_filter()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎</code> عن تعبير نمطي وتستبدله.

== الوصف ==
<syntaxhighlight lang="php">
mixed preg_filter ( mixed $pattern , mixed $replacement , mixed $subject [, int $limit = -1 [, int &$count ]] )
</syntaxhighlight>تشبه الدالة <code>preg_filter()‎‎</code> الدالة <code>[[PHP/preg replace|preg_replace()‎‎]]</code> باستثناء أنها تعيد فقط السلاسل النصية (التي يمكن تحويلها) إذا كانت مطابقة. لمزيد من التفاصيل حول كيفية عمل هذه الدالة، اقرأ توثيق <code>[[PHP/preg replace|preg_replace()‎‎]]</code>.

== القيم المعادة ==
تُعيد هذه الدالة [[PHP/Types/array|مصفوفة]] إذا كان المعامل <code>subject</code> عبارة عن [[PHP/Types/array|مصفوفة]]، أو سلسلة [[PHP/Types/string|نصية]] إذا كان خلاف ذلك.

إذا لم يُعثر على مطابقات أو حدث خطأ، تُعيد هذه الدالة [[PHP/Types/array|مصفوفة]] فارغة عندما يكون <code>subject</code> عبارة عن [[PHP/Types/array|مصفوفة]] أو <code>NULL</code> إذا كان خلاف ذلك.

== أمثلة ==
المثال 1: مثال على مقارنة الدالة <code>preg_filter()‎‎</code> مع الدالة [[PHP/preg replace|<code>preg_replace()</code>‎‎]]<syntaxhighlight lang="php">
<?php
$subject = array('1', 'a', '2', 'b', '3', 'A', 'B', '4'); 
$pattern = array('/\d/', '/[a-z]/', '/[1a]/'); 
$replace = array('A:$0', 'B:$0', 'C:$0'); 

echo "preg_filter returns\n";
print_r(preg_filter($pattern, $replace, $subject)); 

echo "preg_replace returns\n";
print_r(preg_replace($pattern, $replace, $subject)); 
?>
</syntaxhighlight>سوف تكون مُخرجات المثال أعلاه كالتالي:<syntaxhighlight lang="php">
preg_filter returns
Array
(
    [0] => A:C:1
    [1] => B:C:a
    [2] => A:2
    [3] => B:b
    [4] => A:3
    [7] => A:4
)
preg_replace returns
Array
(
    [0] => A:C:1
    [1] => B:C:a
    [2] => A:2
    [3] => B:b
    [4] => A:3
    [5] => A
    [6] => B
    [7] => A:4
)
</syntaxhighlight>

== انظر أيضًا ==
* [[PHP/pcre pattern|أنماط PCRE]].
* الدالة <code>[[PHP/preg quote|preg_quote()‎‎]]</code>: اقتباس حروف التعبير النمطية.
* الدالة <code>[[PHP/preg replace|preg_replace()]]</code>‎‎:البحث عن تعبير نمطي واستبداله.
* الدالة <code>[[PHP/preg replace callback|preg_replace_callback()‎‎]]</code>: البحث عن تعبير نمطي واستبداله باستخدام دالة رد النداء.
* الدالة <code>[[PHP/preg grep|preg_grep()‎‎]]</code>: إعادة عناصر المصفوفة التي تطابق النمط.
* الدالة <code>[[PHP/preg last error|preg_last_error()‎‎]]</code>: إعادة رمز الخطأ الخاص بتنفيذ آخر PCRE regex.

== مصادر ==
* [http://php.net/manual/en/function.preg-filter.php صفحة الدالة preg_filter‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP PCRE]]
[[تصنيف:PHP Regular Expressions]]