Funkcióblokk PREG_REPLACE

A Funkcióblokk PREG_REPLACE keres és cserél reguláris kifejezésekkel.

Megjegyzés: Ez a függvény Binary-Safe. Ez azt jelenti, hogy az UTF8 karaktereket nem lehet közvetlenül kezelni.

PATTERN bemenet

A kifejezés szöveglánc formájában, amely után keresünk. Elérhető néhány PCRE-modifikátor is.

REPLACEMENT bemenet

A szöveglánc a cseréhez. Ez tartalmazhat referenciákat az alábbi formában: \n vagy $n, utóbbit azonban előnyösebb használni. Mindegyik referencia a szöveggel lesz helyettesítve, amelyet az n-edik zárójelbe zárt keresőmintázat fog meg. Az n értéke 0 és 99 között lehet. A \0 vagy a $0 utal a szövegre, amely az egész keresőmintázatra illeszthető. A befogó részkeresőmintázat számának megkapásához a nyitó zárójeleket balról jobbra 1-től kezdve számozzuk. A cserében egy backslash használatához meg kell duplázni "\\".

Ha olyan cserével szeretne dolgozni, ahol egy visszahivatkozás után közvetlenül egy szám következik (azaz a keresőmintázatnak megfelelő szöveg után egy számot szeretne elhelyezni), akkor nem használhatja a \1 formájú visszahivatkozást. Például a \11 zavarhatná a függvényt, mert nem tudja eldönteni, hogy a \1 visszahivatkozást követi-e a 1 szám vagy csak a \11 visszahivatkozást szeretné használni. Ebben az esetben a megoldás a ${1}1 használata. Így egy izolált visszahivatkozást $1 hoz létre, és az 1 marad betűszimbólum.

Ha a megavult e modifikátort használja, ez a függvény néhány karaktert (pontosabban: ', ", \ és NULL) maszkol a szövegláncokban, amelyekkel a visszahivatkozások helyettesítik. Ez azért történik, hogy biztosítsa, hogy nincs szintaxis hibák, ha olyan visszahivatkozást használ, amely egyszerű vagy duplakötőjel tartalmaz. Győződjön meg arról, hogy ismeri a szöveglánc szintaxist, hogy pontosan tudja, milyen a kiértékelt szöveglánc.

SUBJECT bemenet

A bemenet meghatározza a keresendő szövegláncot.

LIMIT bemenet

A maximális lehetséges cserék száma minden keresőmintázatra minden subject-ben. Alapértelmezett érték: -1 vagy NULL (nincs limit).

Q kimenet

Ha találkozásokat találtak, akkor a Q új szövegláncot adja vissza, egyébként a SUBJECT változatlanul kerül visszaadásra vagy NULL, ha hiba történt.

COUNT kimenet

A kimenet visszaadja az elvégzett cserék számát.