وظيفة PHP str_replace()

مثال

استبدل الحرف "world" بـ "Peter" في السلسلة "Hello World!":

<?phpecho str_replace("world"،"Peter"،"Hello World!")؛؟>

التعريف والاستخدام

تستبدل الدالة str_replace() بعض الأحرف في سلسلة (حساسة لحالة الأحرف).

يجب أن تتبع الوظيفة القواعد التالية:

إذا كانت السلسلة التي تم البحث عنها عبارة عن مصفوفة، فسوف تُرجع مصفوفة.

إذا كانت السلسلة التي يتم البحث عنها عبارة عن مصفوفة، فسوف تقوم بالبحث عن كل عنصر في المصفوفة واستبداله.

إذا كانت هناك حاجة إلى البحث عن مصفوفة واستبدالها في نفس الوقت، وكانت العناصر المراد استبدالها أقل من عدد العناصر الموجودة، فسيتم استبدال العناصر الزائدة بسلاسل فارغة.

إذا قمت بالبحث في مصفوفة واستبدلت سلسلة واحدة فقط، فسيتم تطبيق سلسلة الاستبدال على جميع القيم التي تم العثور عليها.

ملاحظة: هذه الوظيفة حساسة لحالة الأحرف. الرجاء استخدام الدالة str_ireplace() لإجراء بحث غير حساس لحالة الأحرف.

ملاحظة: هذه الوظيفة آمنة ثنائيًا.

القواعد

 str_replace ( بحث، استبدال، سلسلة، العد )

المعلمة	يصف
يجد	مطلوب. يحدد القيمة التي يجب البحث عنها.
يستبدل	مطلوب. يحدد القيمة التي ستحل محل القيمة في البحث .
خيط	مطلوب. يحدد السلسلة المراد البحث عنها.
عدد	خياري. متغير يحسب عدد البدائل.

التفاصيل الفنية

قيمة الإرجاع:	تقوم بإرجاع سلسلة أو صفيف بقيم بديلة.
نسخة PHP:	4+
سجل التحديث:	في PHP 5.0، تمت إضافة المعلمة count . قبل PHP 4.3.3، واجهت هذه الوظيفة مشكلة عندما كانت معلمات البحث والاستبدال الخاصة بها عبارة عن مصفوفات، مما تسبب في تجاهل فهرس البحث الفارغ عندما لم يتم استبدال المؤشر الداخلي في مصفوفة الاستبدال . النسخة الجديدة لن تواجه هذه المشكلة اعتبارًا من PHP 4.0.5، يمكن أن تكون معظم المعلمات عبارة عن مصفوفة.

المزيد من الأمثلة

مثال 1

استخدم الدالة str_replace() مع المصفوفة ومتغير العدد:

<?php$arr = array("blue"،red"،green"،green"،yellow")؛print_r(str_replace("red"،pink"،$arr,$i));echo "البدائل: $ أنا";؟>

مثال 2

استخدم الدالة str_replace() مع عناصر أقل للاستبدال مما تم العثور عليه:

<?php$find = array("Hello"، "world")؛$replace = array("B");$arr = array("Hello"، "world"،!")؛print_r(str_replace($) تجد،$استبدال،$arr))؛؟>