STR_SUBSTITUTE

Verwenden Sie Script-Funktion STR_SUBSTITUTE, um Zeichen oder Strings innerhalb eines Strings zu ersetzen. Diese Script-Funktion kann auch dazu verwendet werden, den Parameter Alt aus dem String zu löschen. Zu diesem Zweck müssen Sie den Parameter Neu mit zwei aufeinanderfolgenden Anführungszeichen ohne Leerzeichen angeben.

Syntax

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

Parameter

• STR_SUB[STITUTE
  Ersetzt ein Zeichen oder einen String innerhalb eines Strings

• String
  Alphanumerischer String, in dem ein Zeichen oder ein String ersetzt werden soll
  Format: Script-Literal oder Script-Variable

• Alt
  (Optional) Alphanumerischer String, der im Parameter String ersetzt werden soll. Die Länge dieses Parameters ist nicht begrenzt. Wenn der Parameter Alt nicht verwendet wird, wird jedes einzelne Leerzeichen durch das Zeichen oder den String ersetzt, das bzw. der im Parameter Neu definiert ist.
  Format: Script-Literal oder Script-Variable
  Standardwert: " " 

• Neu
  (Optional) Alphanumerischer String, der Alt ersetzen soll Die Länge dieses Parameters ist nicht begrenzt. Wenn Sie den Parameter Neu nicht verwenden, wird der Parameter Alt durch ein einzelnes Leerzeichen ersetzt.
  Format: Script-Literal oder Script-Variable
  Standardwert: " "

Rückgabewert

• Der neue String, der durch die Ersetzung von Zeichen entstanden ist
• Wenn die Definition von Alt nicht Teil des Parameters String ist, gibt diese Script-Funktion den ursprünglichen String ohne Änderungen zurück.

Beispiel

Das folgende Script ersetzt den String "environment" durch den String "system". Das Ergebnis ist der neue String "AE system":

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

Das folgende Beispiel ersetzt das Zeichen A durch das Zeichen B. Das Ergebnis ist BBBBB und 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: