بلوک عملکرد PREG_REPLACE

بلوک عملکرد PREG_REPLACE با استفاده از عبارات منظم جستجو و جایگزینی انجام می‌دهد.

توجه: این تابع Binary-Safe است. این معنی دارد که کاراکترهای UTF8 به صورت مستقیم قابل پردازش نیستند.

ورودی PATTERN

عبارت به عنوان رشته‌ای که جستجو می‌شود. برخی از تغییر دهنده‌های PCRE نیز در دسترس هستند.

ورودی REPLACEMENT

رشته برای جایگزینی. این اجازه دارد که مراجع در شکل \n یا $n را شامل شود، که آخرین مورد ترجیح داده می‌شود. هر یک از این مراجع با متن جایگزین می‌شود که توسط الگوی جستجو n-ام گرفته شده‌است. 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

خروجی تعداد جایگزینی‌هایی را که انجام شده‌است را برگشت می‌دهد.