دالة PHP preg_filter ()
مثال
لف الأرقام بين قوسين في قائمة سلاسل:
<?php
$input = [
"It is 5 o'clock",
"40 days",
"No
numbers here",
"In the year 2000"
];
$result =
preg_filter('/[0-9]+/', '($0)', $input);
print_r($result);
?>
التعريف والاستخدام
تقوم preg_filter()
الدالة بإرجاع سلسلة أو مصفوفة من السلاسل التي تم فيها استبدال تطابقات النمط بسلسلة الاستبدال.
إذا كان الإدخال عبارة عن مصفوفة ، فإن هذه الدالة ترجع مصفوفة. إذا كان الإدخال عبارة عن سلسلة ، فإن هذه الوظيفة ترجع سلسلة.
تشبه هذه الوظيفة preg_replace()
مع اختلاف واحد: عندما لا يتم العثور على تطابق للنمط في سلسلة إدخال ، فلن يتم استخدام السلسلة في القيمة المرجعة. في هذا السيناريو ، إذا كان الإدخال عبارة عن سلسلة بدلاً من مصفوفة ، فستُرجع الدالة قيمة خالية .
قد تحتوي سلاسل الاستبدال على إشارات خلفية في النموذج \ n أو $ n حيث يمثل n فهرس مجموعة في النمط. في السلسلة التي تم إرجاعها ، سيتم استبدال مثيلات \ n و $ n بالسلسلة الفرعية المطابقة للمجموعة أو ، إذا تم استخدام \ 0 أو $ 0 ، بواسطة التعبير بأكمله.
بناء الجملة
preg_filter(pattern, replacement, input, limit, count)
قيمه المعامل
Parameter | Description |
---|---|
pattern | Required. Contains a regular expression indicating what to search for |
replacement | Required. A string which will replace the matched patterns. It may contain backreferences |
input | Required. A string or array of strings in which the 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: | 5.3.0 |
❮ مرجع PHP RegExp