STR_SUBSTITUTE

Script-Funktion: Ersetzt Zeichen oder Strings innerhalb eines Strings

Syntax

STR_SUB[STITUTE] (String, [Alt] [,Neu])

Syntax	Beschreibung/Format
String	Alphanumerischer String, in dem der Ersatz durchgeführt werden soll: Format: Script-Literal oder Script-Variable
Alt	Alphanumerischer String, der im String ersetzt werden soll. Format: Script-Literal oder Script-Variable Standardwert: ""
Neu	Alphanumerischer String zum Ersetzen von Alt Format: Script-Literal oder Script-Variable Standardwert: ""

Rückgabewert
String, der durch die Ersetzung von Zeichen entstanden ist

Die Script-Funktion ersetzt ein Zeichen oder einen String innerhalb eines Strings.

Alt und Neu sind optional und nicht beschränkt. Wurde Alt nicht als Parameter angegeben, wird jedes einzelne Leerzeichen durch das Zeichen bzw. den String Neu ersetzt. Wurde Neu nicht als Parameter verwendet, wird Alt durch ein einzelnes Leerzeichen ersetzt.

Kommt Alt im String nicht vor, gibt die Funktion den String zurück.

Die Script-Funktion kann auch dazu verwendet werden, Alt aus dem String zu löschen. Dafür muss Neu durch zwei aufeinanderfolgende Hochkommata (ohne Leerzeichen) angegeben werden.

Beispiel

Das folgende Script ersetzt den String environment durch den String system, woraus sich der String AE system ergibt:

: 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 den String AAAAA durch das Zeichen B. Das Ergebnis B wird im Aktivierungsreport ausgegeben.

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

Das folgende Beispiel ersetzt den String AA durch den String 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 einem String löscht. Das Ergebnis AE wird im Aktivierungsreport ausgegeben.

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

Siehe auch: