عرض مصدر PHP/str ireplace

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

الدالة <code>str_ireplace()‎</code> هي إصدار غير حساس لحالة الأحرف من الدالة <code>[[PHP/str replace|str_replace()‎]]</code>.

== الوصف ==
<syntaxhighlight lang="php">
mixed str_ireplace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] )
</syntaxhighlight>تعيد الدالة <code>str_ireplace()‎</code> سلسلةً نصية أو مصفوفة مع تبديل كل حالات المعامل <code>search</code> في المعامل <code>subject</code> (مع تجاهل حالة الأحرف) إلى قيمة المعامل <code>replace</code> المعطاة. إذا كنت لا تحتاج إلى قواعد استبدال تستعمل التعابير النمطية فيجب عليك استخدام هذه الدالة عمومًا بدلاً من الدالة <code>[[PHP/preg replace|preg_replace()‎]]</code> مع المعدّل <code>i</code>.

== المعاملات ==
إذا كان المعامل <code>search</code> والمعامل <code>replace</code> مصفوفتين، فإن <code>str_ireplace()‎</code> تأخذ قيمة من كل مصفوفة وتستخدمها للبحث والاستبدال في المعامل <code>subject</code>. إذا كان المعامل <code>replace</code> يحتوي على قيم أقل من المعامل <code>search</code> ، فستستخدَم سلسلة نصية فارغة لبقية قيم الاستبدال. إذا كان المعامل <code>search</code> مصفوفةً والمعامل <code>replace</code> سلسلةً نصيةً، فستستخدَم  سلسلة الاستبدال هذه لكل قيمة من قيم المعامل <code>search</code>. ومع ذلك، فإن العكس ليس له معنى.

إذا كان المعامل <code>search</code> أو المعامل <code>replace</code> مصفوفتين، فستُعَالَج عناصرهما من العنصر الأوّل إلى العنصر الأخير.

=== <code>search</code> ===
القيمة التي يُبحَث عنها، والمعروفة باسم الإبرة (needle). يمكن استخدام مصفوفة لضبط قيم متعددة.

=== <code>replace</code> ===
قيمة الاستبدال التي تحل محل قيم المعامل <code>search</code> التي عُثِرَ عليها. يمكن استخدام مصفوفة لتعيين بدائل متعددة.

=== <code>subject</code> ===
السلسلة أو المصفوفة التي يبحث عنها وتُسْتَبْدَل، والمعروفة باسم كومة القش (<code>haystack</code>).

إذا كان المعامل <code>subject</code> مصفوفةً، فستجرى عملية البحث والاستبدال مع كل مَدْخَل للمعامل <code>subject</code>، وتصبح القيمة المعادة مصفوفة أيضًا.

=== <code>count</code> ===
إذا مُرِّرَ المعامل <code>count</code>، فسيُعَيَّن بعدد عمليات الاستبدال التي نُفِّذَت.

== القيم المعادة ==
تعيد الدالة <code>str_ireplace()‎</code> سلسلة نصية أو مصفوفة من الاستبدالات.

== أمثلة ==
المثال 1: مثال على الدالة <code>str_ireplace()‎</code><syntaxhighlight lang="php">
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>
</syntaxhighlight>

== ملاحظات ==
هذه الدالة هي آمنة ثنائيًا (binary-safe).

تحذير: نظرًا لأنَّ الدالة <code>str_ireplace()‎</code> تجري عملية الاستبدال من اليسار إلى اليمين، فقد تستبدل قيمةً أُدْخِلَتْ مسبقًا عند إجراء عمليات استبدال متعددة. يوضح المثال رقم 2 في توثيق الدالة <code>[[PHP/str replace|str_replace()‎]]</code> كيف قد يحدث ذلك عمليًا.

== انظر أيضًا ==
* الدالة <code>[[PHP/str replace|str_replace()‎]]</code>: تبديل كل حالات مطابقة سلسلة البحث إلى سلسلة الاستبدال.
* الدالة <code>[[PHP/preg replace|preg_replace()‎]]</code>: إجراء عملية بحث واستبدال باستعمال التعابير النمطية (regular expressions).
* الدالة <code>[[PHP/strtr|strtr()‎]]</code>: تحويل الأحرف أو استبدال سلاسل نصية فرعية.

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