Funktionsblok PREG_REPLACE

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

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

Indgang PATTERN

Udtrykket som streng, efter hvilket der søges. Der findes 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 vil blive erstattet med teksten, der er fanget af det n-te indklammede søgemønster. n kan have en værdi fra 0 til 99. \0 eller $0 henviser til teksten, der passer på det fulde søgemønster. For at få nummeret af det fangende del-søgemønster tælles åbne klammere med 1 startende fra venstre mod højre. For at bruge en backslash i erstatningen skal den fordobles "\\".

Hvis du vil arbejde med en erstatning, hvor der direkte efter en tilbagehenvisning følger et tal (dvs. direkte efter overensstemmelsen 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. Dermed oprettes 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 strenge, som bruges til at erstatte tilbagehenvisninger. 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 streng-syntaksen for præcist 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 overensstemmelser, returneres den nye streng Q; ellers returneres SUBJECT uændret eller NULL, hvis der opstod en fejl.

Udgang COUNT

Udgangen returnerer antallet af foretagne erstatninger.