Funktionsblok PREG_FILTER

Funktionsblokken PREG_FILTER søger og erstatter med regulære udtryk.

Bemærk: Denne funktion er Binary-Safe. Dette betyder, at UTF8-tegn ikke kan behandles direkte.

Udover det faktum, at funktionsblokken PREG_FILTER kun returnerer strengene (måske konverterede) ved sammenligninger, er den identisk med funktionsblokken PREG_REPLACE.

Indgang PATTERN

Udtrykket som streng, der søges efter. Der er også nogle PCRE-modifikatorer til rådighed.

Indgang REPLACEMENT

Strengen til erstatning. Denne må indeholde referencer i form af \n eller $n, hvor sidstnævnte er at foretrække. Hver af disse referencer bliver erstattet med teksten, der er fanget af det n-te indrammede søgemønster. n kan have en værdi fra 0 til 99. \0 eller $0 henviser til teksten, der passer på det fuldstændige søgemønster. For at få nummeret for det indrammede del-søgemønster tælles åbne paranteser med 1, begyndende fra venstre mod højre. For at bruge en backslash i erstatningen skal den fordobles "\\".

Hvis du vil arbejde med en erstatning, hvor en tilbagehenvisning direkte følges af et tal (dvs. umiddelbart efter sammenligningen med et søgemønster skal der komme et tal), kan du ikke bruge skriveformen \1 til din tilbagehenvisning. For eksempel ville \11 forvirre funktionen, fordi den ikke ved, om du vil have tilbagehenvisningen \1 efterfulgt af tallet 1 eller blot tilbagehenvisningen \11. I dette tilfælde er løsningen at bruge ${1}1. Dette skaber en isoleret tilbagehenvisning $1, og 1 forbliver et bogstavsymbol.

Hvis du bruger den forældede modifikator e, maskerer denne funktion nogle tegn (nærmere bestemt ', ", \ og NULL) i strengene, som tilbagehenvisningerne erstatter. Dette gøres for at sikre, at der ikke opstår syntaksfejl, når der bruges tilbagehenvisninger, der indeholder enkle eller dobbelte anførselstegn. Sørg for, at du kender strengensyntaksen for nøjagtigt at vide, hvordan den evaluerede streng ser ud.

Indgang SUBJECT

Indgangen definerer strengen til at gennemgå.

Indgang LIMIT

Den maksimale mulige antal erstatninger for hvert søgemønster i hver subject. Standardværdi: -1 eller NULL (ingen grænse).

Udgang Q

Hvis der er fundet sammenligninger (måske konverterede), returneres den nye streng Q, ellers returneres SUBJECT uændret eller NULL, hvis en fejl opstod.

Udgang COUNT

Udgangen returnerer antallet af foretagne erstatninger.