كتلة الوظيفة PREG_FILTER

تبحث كتلة الوظيفة PREG_FILTER وتستبدل باستخدام التعابير العادية.

ملاحظة: هذه الدالة آمنة الثنائية. وهذا يعني أن الأحرف UTF8 لا يمكن معالجتها مباشرة.

بخلاف ذلك، فإن كتلة الوظيفة PREG_FILTER تعيد فقط عند المطابقة (السلاسل النصية المحولة بشكل محتمل) ، فهي متطابقة مع كتلة الوظيفة PREG_REPLACE.

مدخل PATTERN

التعبير كسلسلة من الأحرف التي يتم البحث عنها. هناك أيضًا بعض تعديلات PCRE المتاحة.

مدخل REPLACEMENT

السلسلة النصية للاستبدال. يمكن أن تحتوي على مراجع في الشكل \n أو $n ، حيث الأخيرة هي الأفضل. يتم استبدال كل من هذه المراجع بالنص الذي تم التقاطه بواسطة النمط البحثي n-th المحدد بالاقواس. يمكن أن يكون n قيمة من 0 إلى 99. \0 أو $0 تشير إلى النص الذي يتطابق مع النمط البحثي الكامل. للحصول على رقم النمط الفرعي المحدد بالاقواس ، يتم عد الأقواس المفتوحة ببدء 1 من اليسار إلى اليمين. لاستخدام شريط عريض في الاستبدال ، يجب أن يكون مضاعفًا "\\".

إذا كنت تريد العمل مع استبدال حيث يلي مرجع رجعي مباشرة رقم آخر (أي بعد المطابقة بنمط بحثي يجب أن يأتي رقم) ، فلا يمكنك استخدام كتابة \1 لمرجعيك. على سبيل المثال ، سيخدع \11 الدالة لأنها لا تعرف ما إذا كنت تريد مرجع رجعي \1 يليه الرقم 1 أو فقط مرجع رجعي \11. في هذه الحالة ، الحل هو استخدام ${1}1. وهذا يخلق مرجعًا رجعيًا معزولًا $1 ويبقى 1 رمز حرف.

إذا كنت تستخدم التعديل القديم e ، فإن هذه الدالة تقنع بعض الأحرف (أي ' ، " ، \ و NULL) في السلاسل النصية التي يتم استبدالها بها المراجع الرجعية. يتم ذلك لضمان عدم حدوث أخطاء في الصياغة عند استخدام المراجع الرجعية التي تحتوي على علامات تنصيص بسيطة أو مزدوجة. تأكد من معرفتك بسلسلة الأحرف لتعرف بالضبط كيف تبدو السلسلة المحللة.

مدخل SUBJECT

يحدد المدخل السلاسل النصية للبحث فيها.

مدخل LIMIT

العدد الأقصى للمستبدلات الممكنة لكل نمط بحثي في كل موضوع. القيمة الافتراضية: -1 أو NULL (لا يوجد حد).

مخرج Q

إذا تم العثور على تطابقات (محتملة التحويل) ، يتم إرجاع السلسلة النصية الجديدة Q ، وإلا يتم إرجاع SUBJECT دون تغيير أو NULL إذا حدث خطأ ما.

مخرج COUNT

يقدم المخرج عدد الاستبدالات التي تم إجراؤها.