Bloc funcțional PREG_FILTER

Blocul funcțional PREG_FILTER caută și înlocuiește cu expresii regulate.

Atenție: Această funcție este Binary-Safe. Acest lucru înseamnă că caracterele UTF8 nu pot fi procesate direct.

Pe lângă faptul că blocul funcțional PREG_FILTER returnază doar șirurile de caractere (posibil convertite) atunci când există potriviri, este identic cu blocul funcțional PREG_REPLACE.

Intrare PATTERN

Expresia ca șir de caractere după care se caută. Sunt disponibile și unele modificatori PCRE.

Intrare REPLACEMENT

Șirul de caractere pentru înlocuire. Acesta poate conține referințe sub forma \n sau $n, acesta din urmă fiind preferabil. Fiecare dintre aceste referințe este înlocuită cu textul capturat de n-ul modelului de căutare parțial încadrat. n poate avea o valoare de la 0 până la 99. \0 sau $0 se referă la textul care se potrivește cu modelul de căutare complet. Pentru a obține numărul modelului de căutare parțial încadrat, parantezele deschise sunt numărate începând de la 1, de la stânga la dreapta. Pentru a utiliza o bară inversă înlocuirea trebuie să fie dublată "\\".

Dacă doriți să lucrați cu o înlocuire în care urmează imediat după o referință inversă un alt număr (adică, imediat după potrivirea cu un model de căutare trebuie să vină un număr), nu puteți utiliza notarea \1 pentru referința dvs. inversă. De exemplu, \11 ar confunda funcția, deoarece nu știe dacă doriți referința inversă \1 urmată de numărul 1 sau doar referința inversă \11. În acest caz, soluția este să utilizați ${1}1. Astfel se creează o referință inversă izolată $1 și 1 rămâne un simbol de literă.

Dacă utilizați modificatorul învechit e, această funcție maschează câteva caractere (anume ', ", \ și NULL) în șirurile de caractere cu care se vor înlocui referințele inverse. Acest lucru se face pentru a asigura că nu apar erori de sintaxă atunci când se utilizează referințe inverse care conțin ghilimele simple sau duble. Asigurați-vă că cunoașteți sintaxa șirurilor de caractere pentru a ști exact cum arată șirul de caractere evaluat.

Intrare SUBJECT

Intrarea definește șirul de caractere pe care trebuie să-l căutați.

Intrare LIMIT

Numărul maxim posibil de înlocuiri pentru fiecare model de căutare în fiecare subiect. Valoarea implicită: -1 sau NULL (fără limită).

Ieșire Q

Dacă s-au găsit potriviri (posibil convertite), șirul de caractere nou Q este returnat, altfel SUBJECT este returnat nemodificat sau NULL, dacă a apărut o eroare.

Ieșire COUNT

Ieșirea returnază numărul de înlocuiri efectuate.