Funktionsblock PREG_FILTER

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

Anmärkning: Denna funktion är Binary-Safe. Detta innebär att UTF8-tecken inte kan bearbetas direkt.

Förutom att funktionsblocket PREG_FILTER endast returnerar strängarna (som möjligen har omvandlats) vid matchningar, är det identiskt med funktionsblocket PREG_REPLACE.

Ingång PATTERN

Uttrycket som en sträng, efter vilket man söker. 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ångades 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 öppna parenteser med 1 från vänster till höger. För att använda ett backslash i ersättningen måste den dubbleras "\\".

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

Om du använder den föråldrade modifikatorn e, maskerar denna funktion några tecken (nämligen ', ", \ och NULL) i strängarna som återreferenserna ersätter. Detta görs för att säkerställa att inga syntaxfel uppstår när återreferenser 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 (möjligen omvandlade) 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.