Funksjonsblokk PREG_REPLACE

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

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

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 formen \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 fra venstre mot 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 at et søkemønster er matchet, skal det komme et tall), kan du ikke bruke notasjonen \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 antall mulige erstatninger for hvert søkemønster i hver subject. Standardverdi: -1 eller NULL (ingen begrensning).

Utgang Q

Hvis det ble funnet treff, returneres den nye strengen Q, ellers returneres SUBJECT uendret eller NULL, hvis en feil oppstod.

Utgang COUNT

Utgangen gir antall utførte erstatninger.