دالة PHP str_replace ()
مثال
استبدل الأحرف "world" في السلسلة "Hello world!" مع "بيتر":
<?php
echo str_replace("world","Peter","Hello world!");
?>
التعريف والاستخدام
تستبدل الدالة str_replace () بعض الأحرف ببعض الأحرف الأخرى في سلسلة.
تعمل هذه الوظيفة بالقواعد التالية:
- إذا كانت السلسلة المراد البحث عنها عبارة عن مصفوفة ، فإنها ترجع مصفوفة
- إذا كانت السلسلة المراد البحث عنها عبارة عن مصفوفة ، فسيتم إجراء البحث والاستبدال مع كل عنصر من عناصر المصفوفة
- إذا كان كل من البحث والاستبدال عبارة عن مصفوفتين ، وكان الاستبدال يحتوي على عناصر أقل من عنصر البحث ، فسيتم استخدام سلسلة فارغة كبديل
- إذا كان find مصفوفة و replace عبارة عن سلسلة ، فسيتم استخدام سلسلة الاستبدال لكل قيمة بحث
ملاحظة: هذه الوظيفة حساسة لحالة الأحرف. استخدم الدالة str_ireplace () لإجراء بحث حساس لحالة الأحرف.
ملاحظة: هذه الوظيفة آمنة ثنائيًا.
بناء الجملة
str_replace(find,replace,string,count)
قيمه المعامل
Parameter | Description |
---|---|
find | Required. Specifies the value to find |
replace | Required. Specifies the value to replace the value in find |
string | Required. Specifies the string to be searched |
count | Optional. A variable that counts the number of replacements |
تفاصيل تقنية
قيمة الإرجاع: | تُرجع سلسلة أو مصفوفة بالقيم المستبدلة |
---|---|
إصدار PHP: | 4+ |
التغيير: | تمت إضافة معلمة count في PHP 5.0 قبل PHP 4.3.3 ، واجهت هذه الوظيفة مشكلة عند استخدام المصفوفات كمعلمات بحث واستبدال ، مما تسبب في تخطي فهارس البحث الفارغة دون تقديم المؤشر الداخلي على مصفوفة الاستبدال . الإصدارات الأحدث لن تحتوي على هذه المشكلة. اعتبارًا من PHP 4.0.5 ، يمكن أن تكون معظم المعلمات الآن مصفوفة |
مزيد من الأمثلة
مثال
باستخدام str_replace () مع مصفوفة ومتغير عدد:
<?php
$arr = array("blue","red","green","yellow");
print_r(str_replace("red","pink",$arr,$i));
echo "Replacements: $i";
?>
مثال
استخدام str_replace () مع عدد أقل من العناصر في الاستبدال عن البحث:
<?php
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?>
❮ مرجع سلسلة PHP