STR_SUBSTITUTE

Script-Funktion: Ersetzt Zeichen oder Zeichenfolgen innerhalb einer Zeichenfolge

Syntax

STR_SUB[STITUTE] (String, [Old] [,New])

Syntax	Beschreibung/Format
String	Alphanumerische Zeichenfolge in der eine Ersetzung durchgeführt werden soll Format: Script-Literal oder Script-Variable
Old	Alphanumerische Zeichenfolge, die in der Zeichenfolge ersetzt werden soll. Format: Script-Literal oder Script-Variable Standardwert: „ “
New	Alphanumerische Zeichenfolge zum Ersetzen von Old Format: Script-Literal oder Script-Variable Standardwert: „ “

Rückgabewert
Zeichenfolge, die durch die Ersetzung von Zeichen entstanden ist

Die Script-Funktion ersetzt ein Zeichen oder eine Zeichenkette innerhalb einer Zeichenkette.

Old und New sind optional und nicht beschränkt. Wurde Old nicht als Parameter angegeben, wird jedes einzelne Leerzeichen durch das Zeichen bzw. die Zeichenfolge New ersetzt. Wurde New nicht als Parameter verwendet, wird Old durch ein einzelnes Leerzeichen ersetzt.

Kommt Old in der Zeichenfolge nicht vor, gibt die Funktion den String zurück.

Die Script-Funktion kann auch dazu verwendet werden, Old aus der Zeichenfolge zu löschen. Dafür muss New durch zwei aufeinanderfolgende Hochkommata (ohne Leerzeichen) angegeben werden.

Beispiel

Das folgende Script ersetzt die Zeichenfolge environment mit der Zeichenfolge system, was zur Folge hat, dass die Zeichenfolge AE system:

:SET &STRING# = STR_SUBSTITUTE("AE environment", "environment", "system")

Das folgende Beispiel ersetzt das Zeichen A durch das Zeichen B. Das Ergebnis BBBBB wird im Aktivierungsreport ausgegeben.

:SET &RET# = STR_SUBSTITUTE ("AAAAA", "A", "B")
:PRINT &RET#

Das folgende Beispiel ersetzt die Zeichenfolge AAAAAAA durch das Zeichen B. Das Ergebnis B wird im Aktivierungsreport ausgegeben.

:SET &RET# = STR_SUBSTITUTE ("AAAAA", "AAAAA", "B")
:PRINT &RET#

Das folgende Beispiel ersetzt die Zeichenfolge AA durch die Zeichenfolge BB. Das Ergebnis BBBBA wird im Aktivierungsreport ausgegeben.

:SET &STR1# = "AA"
:SET &STR2# = "BB"
:SET &RET# = STR_SUB ("AAAAA", &STR1#, &STR2#)
:PRINT &RET#

Das folgende Beispiel zeigt, wie man Leerzeichen aus einer Zeichenfolge löscht. Das Ergebnis AE wird im Aktivierungsreport ausgegeben.

:SET &RET# = STR_SUB ("A E", " ", "")
:PRINT  &RET#

Siehe auch: