Funktionsblock PREG_REPLACE

Der Funktionsblock PREG_REPLACE sucht und ersetzt mit regulären Ausdrücken.

Hinweis: Diese Funktion ist Binary-Safe. Dies bedeutet, dass UTF8-Zeichen nicht direkt bearbeitet werden können.

Eingang PATTERN

Der Ausdruck als Zeichenkette, nach dem gesucht wird. Es stehen auch einige PCRE-Modifikatoren zur Verfügung.

Eingang REPLACEMENT

Die Zeichenkette zum Ersetzen. Diese darf Referenzen in der Form \n oder $n enthalten, wobei Letztere vorzuziehen ist. Jede dieser Referenzen wird mit dem Text ersetzt, der vom n-ten eingeklammerten Suchmuster erfasst wurde. n kann einen Wert von 0 bis 99 haben. \0 oder $0 beziehen sich auf den Text, der auf das komplette Suchmuster passt. Um die Nummer des erfassenden Teil-Suchmusters zu erhalten, werden öffnende Klammern mit 1 beginnend von links nach rechts gezählt. Um einen Backslash im Ersatz zu verwenden, muss er verdoppelt werden "\\".

Wenn Sie mit einer Ersetzung arbeiten wollen, in der auf eine Rückreferenzierung direkt eine weitere Zahl folgt (d.h., direkt nach der Übereinstimmung mit einem Suchmuster soll eine Zahl kommen), können Sie für Ihre Rückreferenzierung nicht die Schreibweise \1 verwenden. So würde z.B. \11 die Funktion verwirren, weil sie nicht weiss, ob Sie die Rückreferenzierung \1 gefolgt von der Zahl 1 wollen oder nur die Rückreferenzierung \11. In diesem Fall ist die Lösung, ${1}1 zu verwenden. Damit wird eine isolierte Rückreferenzierung $1 erzeugt und die 1 bleibt ein Buchstabensymbol.

Wenn Sie den veralteten Modifikator e verwenden, maskiert diese Funktion ein paar Zeichen (nämlich ', ", \ und NULL) in den Zeichenketten, mit denen die Rückreferenzierungen ersetzen werden. Das wird gemacht, um sicherzustellen, dass keine Syntaxfehler entstehen, wenn Rückreferenzierungen verwendet werden, die einfache oder doppelte Anführungszeichen enthalten. Vergewissern Sie sich, dass Sie die Zeichenketten-Syntax kennen, um genau zu wissen, wie die ausgewertete Zeichenkette aussieht.

Eingang SUBJECT

Der Eingang definiert die Zeichenkette zum Durchsuchen.

Eingang LIMIT

Die maximal mögliche Anzahl von Ersetzungen für jedes Suchmuster in jeder subject. Standardmässiger Wert: -1 oder NULL (kein Limit).

Ausgang Q

Falls Übereinstimmungen gefunden wurden, wird die neue Zeichenkette Q zurückgegeben, andernfalls wird SUBJECT unverändert zurückgegeben oder NULL, falls ein Fehler auftrat.

Ausgang COUNT

Der Ausgang gibt die Anzahl der vorgenommener Ersetzungen zurück.