Funksjonsblokk PREG_FILTER

Funksjonsblokken PREG_FILTER søker og erstatter med regulære uttrykk.

Merk: Denne funksjonen er Binary-Safe. Dette betyr at UTF8-tegn ikke kan bearbeides direkte.

Utenom at funksjonsblokken PREG_FILTER bare gir tilbake tegnkjeder (muligens konverterte) ved samsvar, er den identisk med funksjonsblokken PREG_REPLACE.

Inngang PATTERN

Uttrykket som en streng, etter hvilket det søkes. Det står også noen PCRE-modifikatorer til disposisjon.

Inngang REPLACEMENT

Strengen for erstatning. Denne kan inneholde referanser i form av \n eller $n, hvor sistnevnte er å foretrekke. Hver av disse referansene blir erstattet med teksten som ble fanget opp av det n-te innklamrede søkemønsteret. n kan ha en verdi fra 0 til 99. \0 eller $0 refererer til teksten som passer på hele søkemønsteret. For å få nummeret på det fangende del-søkemønsteret, teller man åpne parenteser med 1 startende fra venstre til høyre. For å bruke en backslash i erstatningen, må den dobles "\\".

Hvis du vil arbeide med en erstatning der det direkte etter en tilbakereferanse følger et tall (det vil si at umiddelbart etter samsvaret med et søkemønster skal et tall komme), kan du ikke bruke skriveformen \1 for din tilbakereferanse. For eksempel ville \11 forvirre funksjonen fordi den ikke vet om du vil ha tilbakereferansen \1 fulgt av tallet 1 eller bare tilbakereferansen \11. I dette tilfellet er løsningen å bruke ${1}1. Dette skaper en isolert tilbakereferanse $1 og 1 blir et bokstavsymbol.

Hvis du bruker den foreldede modifikatoren e, maskerer denne funksjonen noen tegn (nærmere bestemt ', ", \ og NULL) i strengene som brukes til å erstatte tilbakereferanser. Dette gjøres for å sikre at det ikke oppstår syntaksfeil når tilbakereferanser som inneholder enkle eller dobbelte anførselstegn brukes. Se til at du kjenner til strengsyntaksen for å vite nøyaktig hvordan den evaluerte strengen ser ut.

Inngang SUBJECT

Inngangen definerer strengen som skal gjennomgås.

Inngang LIMIT

Den maksimale mulige antall erstatninger for hvert søkemønster i hver subject. Standardverdi: -1 eller NULL (ingen begrensning).

Utgang Q

Hvis samsvar (muligens konverterte) ble funnet, returneres den nye strengen Q, ellers returneres SUBJECT uendret eller NULL, hvis en feil oppstod.

Utgang COUNT

Utgangen gir antall utførte erstatninger.