Ersetzt ein oder mehrere Zeichen in einem String.
StringReplace ( "string", "searchstring/start", "replacestring" [, occurrence [, casesense]] )
Parameter
| string | Der auszuwertende String. |
| searchstring/start | Der Teilstring, die 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) [Anzahl < 0 ersetzt ebenfalls alles] |
| 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 "count" positiv ist wird das Suchen/Ersetzen von links nach rechts durchgeführt. Deshalb gibt StringReplace("aaa", "aa", "bb") "bba" zurück.
Verwandte Funktionen
StringLeft, StringLen, StringLower, StringMid, StringRight, StringTrimLeft, StringTrimRight, StringUpper, StringStripWS, StringAddCR
Beispiel
$text = StringReplace("Dies ist eine Zeile mit Text", " ", "-")
$numreplacements = @extended
MsgBox(0, "Der neue String", $text)
MsgBox(0, "Anzahl an Ersetzungen", $numreplacements)