الدالة str_ireplace() في PHP
(PHP 5, PHP 7)
الدالة str_ireplace() هي إصدار غير حساس لحالة الأحرف من الدالة str_replace().
الوصف
mixed str_ireplace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] )
تعيد الدالة str_ireplace() سلسلةً نصية أو مصفوفة مع تبديل كل حالات المعامل search في المعامل subject (مع تجاهل حالة الأحرف) إلى قيمة المعامل replace المعطاة. إذا كنت لا تحتاج إلى قواعد استبدال تستعمل التعابير النمطية فيجب عليك استخدام هذه الدالة عمومًا بدلاً من الدالة preg_replace() مع المعدّل i.
المعاملات
إذا كان المعامل search والمعامل replace مصفوفتين، فإن str_ireplace() تأخذ قيمة من كل مصفوفة وتستخدمها للبحث والاستبدال في المعامل subject. إذا كان المعامل replace يحتوي على قيم أقل من المعامل search ، فستستخدَم سلسلة نصية فارغة لبقية قيم الاستبدال. إذا كان المعامل search مصفوفةً والمعامل replace سلسلةً نصيةً، فستستخدَم سلسلة الاستبدال هذه لكل قيمة من قيم المعامل search. ومع ذلك، فإن العكس ليس له معنى.
إذا كان المعامل search أو المعامل replace مصفوفتين، فستُعَالَج عناصرهما من العنصر الأوّل إلى العنصر الأخير.
search
القيمة التي يُبحَث عنها، والمعروفة باسم الإبرة (needle). يمكن استخدام مصفوفة لضبط قيم متعددة.
replace
قيمة الاستبدال التي تحل محل قيم المعامل search التي عُثِرَ عليها. يمكن استخدام مصفوفة لتعيين بدائل متعددة.
subject
السلسلة أو المصفوفة التي يبحث عنها وتُسْتَبْدَل، والمعروفة باسم كومة القش (haystack).
إذا كان المعامل subject مصفوفةً، فستجرى عملية البحث والاستبدال مع كل مَدْخَل للمعامل subject، وتصبح القيمة المعادة مصفوفة أيضًا.
count
إذا مُرِّرَ المعامل count، فسيُعَيَّن بعدد عمليات الاستبدال التي نُفِّذَت.
القيم المعادة
تعيد الدالة str_ireplace() سلسلة نصية أو مصفوفة من الاستبدالات.
أمثلة
المثال 1: مثال على الدالة str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>
ملاحظات
هذه الدالة هي آمنة ثنائيًا (binary-safe).
تحذير: نظرًا لأنَّ الدالة str_ireplace() تجري عملية الاستبدال من اليسار إلى اليمين، فقد تستبدل قيمةً أُدْخِلَتْ مسبقًا عند إجراء عمليات استبدال متعددة. يوضح المثال رقم 2 في توثيق الدالة str_replace() كيف قد يحدث ذلك عمليًا.
انظر أيضًا
- الدالة
str_replace(): تبديل كل حالات مطابقة سلسلة البحث إلى سلسلة الاستبدال. - الدالة
preg_replace(): إجراء عملية بحث واستبدال باستعمال التعابير النمطية (regular expressions). - الدالة
strtr(): تحويل الأحرف أو استبدال سلاسل نصية فرعية.