عرض مصدر PHP/preg replace callback array

<noinclude>{{DISPLAYTITLE:الدالة <code>preg_replace_callback_array()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في PHP}}</noinclude>
(PHP 7)

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

== الوصف ==
<syntaxhighlight lang="php">
mixed preg_replace_callback_array ( array $patterns_and_callbacks , mixed $subject [, int$limit = -1 [, int &$count ]] )
</syntaxhighlight>يشبه سلوك هذه الدالة سلوك الدالة <code>[[PHP/preg replace callback|preg_replace_callback()‎‎]]</code>، باستثناء أنها تُنفِّذ الدوال المُعرّفة من المستخدم أساس كل نمط.

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

=== <code>patterns_and_callbacks</code> ===
مصفوفة مرتبطة تربط الأنماط (المفاتيح) مع الدوال المُعرّفة من المستخدم (القيم).

=== <code>subject</code> ===
السلسلة النصية، أو مصفوفة من السلاسل النصية المراد البحث والاستبدال فيها.

=== <code>limit</code> ===
أقصى عدد بدائل ممكنة من كل نمط متواجد في كل سلسلة <code>subject</code>. قيمته الافتراضية ‎-1 (بلا حدود).

=== <code>count</code> ===
إذا حُدِد فستصبح قيمة هذا المتغير تساوي عدد عمليات الاستبدال.

== القيم المعادة ==
تُعيد هذه الدالة مصفوفةً إذا كانت المعامل <code>subject</code> يمثل مصفوفة، أو تُعيد سلسلةً نصية خلاف ذلك. في حالة وجود خطأ تكون القيمة المعادة هي <code>NULL</code>.

إذا عُثِرَ على تطابقات، تُعاد السلسلة النصية الهدف الجديدة، وإلا تُعاد السلسلة الهدف الأصلية <code>subject</code> دون تغيير.

== أمثلة ==
المثال 1: مثال على الدالة <code>preg_replace_callback_array()‎‎</code><syntaxhighlight lang="php">
<?php
$subject = 'Aaaaaa Bbb';

preg_replace_callback_array(
    [
        '~[a]+~i' => function ($match) {
            echo strlen($match[0]), ' matches for "a" found', PHP_EOL;
        },
        '~[b]+~i' => function ($match) {
            echo strlen($match[0]), ' matches for "b" found', PHP_EOL;
        }
    ],
    $subject
);
?>
</syntaxhighlight>سوف تكون مُخرجات المثال أعلاه كالتالي:<syntaxhighlight lang="php">
6 matches for "a" found
3 matches for "b" found
</syntaxhighlight>

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

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