دالة PHP preg_replace ()
مثال
استخدم تعبيرًا عاديًا غير حساس لحالة الأحرف لاستبدال Microsoft بـ W3Schools في سلسلة:
<?php
$str = 'Visit Microsoft!';
$pattern = '/microsoft/i';
echo
preg_replace($pattern, 'W3Schools', $str);
?>
التعريف والاستخدام
ترجع preg_replace()
الدالة سلسلة أو مصفوفة من السلاسل حيث يتم استبدال جميع التطابقات الخاصة بالنمط أو قائمة الأنماط الموجودة في الإدخال بسلاسل فرعية.
هناك ثلاث طرق مختلفة لاستخدام هذه الوظيفة:
1. نمط واحد وخيط بديل. يتم استبدال تطابقات النمط بسلسلة الاستبدال.
2. مجموعة من الأنماط وسلسلة بديلة. يتم استبدال التطابقات مع أي من الأنماط بسلسلة الاستبدال.
3. مجموعة من الأنماط ومجموعة من السلاسل البديلة. يتم استبدال التطابقات من كل نمط بسلسلة الاستبدال في نفس الموضع في صفيف الاستبدالات. إذا لم يتم العثور على عنصر في هذا الموضع ، يتم استبدال المطابقة بسلسلة فارغة.
قد تحتوي سلاسل الاستبدال على مرجع خلفي بالشكل \ n أو $ n حيث يمثل n فهرس مجموعة في النمط. في السلسلة التي تم إرجاعها ، سيتم استبدال مثيلات \ n و $ n بالسلسلة الفرعية المطابقة للمجموعة أو ، إذا تم استخدام \ 0 أو $ 0 ، بواسطة التعبير بأكمله.
ملاحظة: لكل سلسلة إدخال ، تقوم الدالة بتقييم الأنماط بالترتيب الذي أعطيت به. يتم استخدام نتيجة تقييم النمط الأول على السلسلة كسلسلة إدخال للنمط الثاني وهكذا. هذا يمكن أن يؤدي إلى سلوك غير متوقع.
بناء الجملة
preg_replace(patterns, replacements, input, limit, count)
قيمه المعامل
Parameter | Description |
---|---|
patterns | Required. Contains a regular expression or array of regular expressions |
replacements | Required. A replacement string or an array of replacement strings |
input | Required. The string or array of strings in which replacements are being performed |
limit | Optional. Defaults to -1, meaning unlimited. Sets a limit to how many replacements can be done in each string |
count | Optional. After the function has executed, this variable will contain a number indicating how many replacements were performed |
تفاصيل تقنية
قيمة الإرجاع: | تُرجع سلسلة أو مصفوفة سلاسل ناتجة عن تطبيق البدائل على سلسلة الإدخال أو السلاسل |
---|---|
إصدار PHP: | 4.0.5+ |
التغيير: | PHP 5.1.0 - تمت إضافة معامل العد |
❮ مرجع PHP RegExp