Bloc funcțional PREG_REPLACE

Blocul funcțional PREG_REPLACE 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.

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 modelul de căutare al n-lea. 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 care capturează, se numără parantezele deschise începând de la stânga la dreapta, pornind de la 1. 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 se caută.

Intrare LIMIT

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

Ieșire Q

Dacă s-au găsit potriviri, ș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 returnează numărul de înlocuiri efectuate.