Bllok Funksion PREG_FILTER

Blloku i funksioneve PREG_FILTER kërkon dhe zëvendëson me shprehje të rregullta.

Shënim: Kjo funksion është Binary-Safe. Kjo do të thotë se karakteret UTF8 nuk mund të përpunohen direkt.

Përveç faktit se blloku i funksioneve PREG_FILTER kthen vetëm vargjet e karaktereve (mbase të konvertuara) në rast të përputhjeve, ai është identik me bllokun e funksioneve PREG_REPLACE.

Hyrja PATTERN

Shprehja si varg karakteresh pas së cilës kërkohet. Janë të disponueshme edhe disa modifikatorë PCRE.

Hyrja REPLACEMENT

Vargu i karaktereve për zëvendësim. Ky mund të përmbajë referenca në formën \n ose $n, ku këto të fundit janë të preferuara. Secila nga këto referenca zëvendësohet me tekstin që është kapur nga modeli i kërkimit i n-të i kapur në paranteza. n mund të ketë një vlerë nga 0 deri në 99. \0 ose $0 referohen tek teksti që përputhet me modelin e kërkimit të plotë. Për të marrë numrin e modelit të kërkimit të pjesës së kapur, parantezat hapëse numërohen duke filluar nga 1 nga majta në djathtë. Për të përdorur një backslash në zëvendësim, duhet të dyfishohet "\\".

Nëse doni të punoni me një zëvendësim ku pas një referimi të mbrapëm vjen direkt një numër tjetër (d.m.th., pas përputhjes me një model kërkimi duhet të vijojë një numër), nuk mund ta përdorni shkrimin \1 për referimin tuaj të mbrapëm. Për shembull, \11 do ta ngatërrojë funksionin sepse nuk e di se doni referimin e mbrapëm \1 i ndjekur nga numri 1 ose vetëm referimin e mbrapëm \11. Në këtë rast, zgjidhja është përdorimi i ${1}1. Kështu krijon një referim të mbrapëm të izoluar $1 dhe 1 mbetet një simbol shkronjor.

Nëse përdorni modifikatorin e vjetruar e, ky funksion maskon disa karaktere (specifikisht ', ", \ dhe NULL) në vargjet e karaktereve me të cilat referencat e mbrapëm do të zëvendësohen. Kjo bëhet për të siguruar që nuk shfaqen gabime sintaksore kur përdoren referenca të mbrapëm që përmbajnë thonjëza të thjeshta ose të dyfishta. Sigurohuni se e dini sintaksën e vargjeve karakteresh për të ditur saktësisht si duket vargu i karaktereve i vlerësuar.

Hyrja SUBJECT

Hyrja e cila përcakton vargun e karaktereve që duhet kërkuar.

Hyrja LIMIT

Numri maksimal i mundshëm i zëvendësimeve për secilin model kërkimi në çdo subjekt. Vlera e parazgjedhur: -1 ose NULL (pa limit).

Dalja Q

Nëse janë gjetur përputhje (mbase të konvertuara), vargu i ri karakteresh Q kthehet, ndryshe SUBJECT kthehet pa ndonjë ndryshim ose NULL, nëse ka ndodhur një gabim.

Dalja COUNT

Dalja kthen numrin e zëvendësimeve të bërë.