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

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

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

مدخل 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

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

مخرج Q

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

مخرج COUNT

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