# Funktionsreferenz

StringReplace

Ersetzt ein oder mehrere Zeichen in einer Zeichenfolge.

StringReplace ( "string", "searchstring" or start, "replacestring" [, count [, casesense]] )

Parameter

string | Die auszuwertende Zeichenfolge.
searchstring | Die Teilzeichenfolge, die gesucht werden soll oder die Position des Zeichens an der das Ersetzten beginnt.
replacestring | Die zu ersetzende Zeichenfolge.
count | [optional] Die Anzahl der Wiederholungen zum Ersetzen des "searchstrings". 0 = alle "searchstrings" werden ersetzt (Vorgabe) [Anzahl < 0 ersetzt ebenfalls alles]
casesense | [optional] Flag zum Kennzeichnen ob die Suchaktion Groß-/Kleinschreibung unterscheidet. 0 = Nein, Groß-/Kleinschreibung wird nicht berücksichtigt (Vorgabe). 1 = Ja, Groß-/Kleinschreibung wird berücksichtigt.

Bemerkungen

Das Suchen/Ersetzen wird von links nach rechts durchgeführt. Deshalb gibt, StringReplace("aaa", "aa", "bb") "bba" zurück.
Wird nur die Grundfunktion benutzt werden "count" und "casesense" Parameter ignoriert. Kann die Ersatzzeichenfolge nicht gespeichert werden wird eine leere Zeichenfolge zurückgegeben und @error auf 0 gesetzt.

Siehe auch

String, StringLeft, StringLen, StringLower, StringMid, StringRight, StringTrimLeft, StringTrimRight, StringUpper

Beispiel

$text = StringReplace("this is a line of text", " ", "-")
$numreplacements = @extended
MsgBox(0, "New string is", $text)
MsgBox(0, "The number of replacements done was", $numreplacements)