Funktionsreferenz

StringReplace

Ersetzt ein oder mehrere Zeichen in einem String.

StringReplace ( "string", "searchstring/start", "replacestring" [, occurrence [, casesense]] )

Parameter

string Der auszuwertende String.
searchstring/start Der Teilstring, der gesucht werden soll oder die Position des Zeichens, an der das Ersetzen beginnt.
replacestring Den zu ersetzenden String.
occurrence [optional] Die Anzahl der Wiederholungen zum Ersetzen des "searchstrings". Wird eine negative Zahl verwendet, so wird von der rechten Seite beginnend gesucht.
0 = alle "searchstrings" werden ersetzt (Standard)
casesense [optional] Flag zum Kennzeichnen ob die Suchaktion Groß-/Kleinschreibung unterscheidet.
0 = Nein, Groß-/Kleinschreibung wird nicht berücksichtigt (Standard).
1 = Ja, Groß-/Kleinschreibung wird berücksichtigt.
2 = Groß- und Kleinschreibung werden nicht berücksichtigt. Es findet ein einfacherer schnellerer Vergleich statt

Rückgabewert

Gibt den neuen String zurück. Die Anzahl der durchgeführten Ersetzungen wird in @extended gespeichert.

Bemerkungen

Standardmäßig oder wenn "occurrence" positiv ist wird das Suchen/Ersetzen von links nach rechts durchgeführt. Deshalb gibt StringReplace("aaa", "aa", "bb") "bba" zurück.

Wird nur die Grundfunktion benutzt, werden die Parameter "occurrence" und "casesense" ignoriert. Kann der Ersatzstring nicht gespeichert werden, wird einen leeren String zurückgegeben und @error auf 1 gesetzt.

Verwandte Funktionen

StringLeft, StringLen, StringLower, StringMid, StringRight, StringTrimLeft, StringTrimRight, StringUpper, StringStripWS, StringAddCR

Beispiel


Local $text = StringReplace("Dies ist eine Zeile mit Text", " ", "-")
Local $numreplacements = @extended
MsgBox(0, "Der neue String", $text)
MsgBox(0, "Anzahl an Ersetzungen", $numreplacements)