Funkcióblokk PREG_FILTER

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

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

A Funkcióblokk PREG_FILTER abban különbözik a Funkcióblokktól PREG_REPLACE, hogy csak akkor adja vissza a (lehetséges átalakított) karakterláncokat, ha találkozás van.

PATTERN bemenet

A kifejezés karakterláncként, amely után keres. Elérhetőek néhány PCRE-modifikátor is.

REPLACEMENT bemenet

A karakterlánc a helyettesítéshez. Ez tartalmazhat referenciákat az alábbi formában: \n vagy $n, utóbbit preferálni kell. Mindegyik ilyen referencia a szöveggel lesz helyettesítve, amelyet az n-edik zárójelezett keresőmintázat fog meg. Az n értéke 0 és 99 között lehet. A \0 vagy $0 a teljes keresőmintázathoz illeszkedő szövegre utal. 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ámozhatjuk. A helyettesítésben egy backslash használatához meg kell duplázni "\\".

Ha olyan helyettesítést szeretne használni, amelyben egy visszahivatkozás után közvetlenül egy szám következik (azaz a keresőmintázat illesztése után egy szám kell jönjön), akkor nem használhatja a \1 formátusú visszahivatkozást. Például a \11 zavarhatná a funkciót, mert nem tudja megkülönböztetni, 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ás $1 lesz létrehozva, és az 1 marad betűszimbólum.

Ha a régimódi e módosítót használja, ez a funkció néhány karaktert (pontosan ', ", \ és NULL) maszkolja a karakterláncokban, amelyekkel a visszahivatkozások helyettesítik. Ez azért történik, hogy biztosítsa, hogy nem keletkeznek szintaxis hibák, ha olyan visszahivatkozást használ, amely egyszerű vagy duplán idézőjeleket tartalmaz. Győződjön meg arról, hogy ismeri a karakterlánc-szintaxist, hogy pontosan tudja, milyen a kiértékelt karakterlánc.

SUBJECT bemenet

A bemenet definiálja a keresendő karakterláncot.

LIMIT bemenet

A maximális lehetséges számú helyettesítések minden keresőmintázatra minden subject-ben. Alapértelmezett érték: -1 vagy NULL (nincs limit).

Q kimenet

Ha találkozásokat találtak (lehetséges átalakított), akkor a Q új karakterlánc lesz visszaadva, egyébként a SUBJECT változatlanul lesz visszaadva vagy NULL, ha hiba történt.

COUNT kimenet

A kimenet visszaadja az elvégzett helyettesítések számát.