Funktionsblock PREG_REPLACE

Funktionsblocket PREG_REPLACE söker och ersätter med reguljära uttryck.

Anmärkning: Denna funktion är binärsäker. Detta innebär att UTF8-tecken inte kan bearbetas direkt.

Ingång PATTERN

Uttrycket som sträng, efter vilket det söks. Det finns också några PCRE-modifikatorer tillgängliga.

Ingång REPLACEMENT

Strängen för ersättning. Denna får innehålla referenser i form av \n eller $n, där den senare är att föredra. Var och en av dessa referenser ersätts med texten som fångats av det n-te parenteserade sökmönstret. n kan ha ett värde från 0 till 99. \0 eller $0 syftar på texten som matchar det fullständiga sökmönstret. För att få nummeret för det fångande del-sökmönstret räknas öppnande parenteser med 1 från vänster till höger. För att använda ett backslash i ersättningen måste den fördubblas "\\".

Om du vill arbeta med en ersättning där en återkoppling direkt följs av en annan siffra (det vill säga, direkt efter matchningen med ett sökmönster ska en siffra komma), kan du inte använda skrivsättet \1 för din återkoppling. Till exempel skulle \11 förvirra funktionen, eftersom den inte vet om du vill ha återkopplingen \1 följt av siffran 1 eller bara återkopplingen \11. I det här fallet är lösningen att använda ${1}1. Detta skapar en isolerad återkoppling $1 och 1 förblir ett tecken.

Om du använder den föråldrade modifikatorn e, maskerar denna funktion några tecken (det vill säga ', ", \ och NULL) i strängarna som återkopplingarna ersätter. Detta görs för att säkerställa att inga syntaxfel uppstår när återkopplingar används som innehåller enkla eller dubbla citattecken. Se till att du känner till strängsyntaxen för att veta exakt hur den utvärderade strängen ser ut.

Ingång SUBJECT

Ingången definierar strängen att söka igenom.

Ingång LIMIT

Den maximala möjliga antalet ersättningar för varje sökmönster i varje subject. Standardvärde: -1 eller NULL (inget gräns).

Utgång Q

Om matchningar hittades, returneras den nya strängen Q, annars returneras SUBJECT oförändrat eller NULL, om ett fel inträffade.

Utgång COUNT

Utgången returnerar antalet gjorda ersättningar.