STR_SUBSTITUTE_VAR, STR_SUB_VAR

Verwenden Sie die Script-Funktion STR_SUBSTITUTE_VAR, um einen oder mehrere Script-Variablennamen, die als String in einer anderen Script-Variablen gespeichert sind, durch den tatsächlichen Variablenwert zu ersetzen. Um die gleiche Art von Ersetzungen in Datensequenzzeilen zu machen, können Sie die Script-Funktion GET_PROCESS_LINE kombiniert mit dem Parameter STR_SUBSTITUTE verwenden. Weitere Informationen finden Sie unter GET_PROCESS_LINE.

Syntax

STR_SUB[STITUTE]_VAR (Variablen)

Parameter

• STR_SBU[STITUTE]_VAR
  Ersetzt die Namen von Script-Variablen durch ihre tatsächlichen Werte.

• Variablen
  Script-Variablen oder Strings, die einen oder mehrere Variablennamen enthalten
  Format: Script-Literal oder Script-Variable

Rückgabewert

String, der den Wert der Script-Variablen enthält

Beispiele

In folgendem Beispiel wird der Name einer Script-Variablen (&VAR#) in einer andere Variablen gespeichert (&VAR_NOSUB#), indem das Ampersand-Zeichen (&) doppelt verwendet wird. Wenn Sie &VAR_NOSUB# ausgeben, erscheint der Name der Script-Variablen &VAR# im Aktivierungsreport. Um den Wert der Variablen auszugeben, können Sie das Script-Element STR_SUB_VAR verwenden, wie in den letzten zwei Zeilen dieses Beispiels gezeigt:

:SET &VAR# = "Script-Variable"
:SET &VAR_NOSUB# = "&&VAR# = &VAR#"
:PRINT &VAR_NOSUB#
:SET &VAR_SUB# = STR_SUB_VAR(&VAR_NOSUB#)
:PRINT &VAR_SUB#

Der Aktivierungsbericht zeigt folgendes Ergebnis:

2022-05-06 10:34:04 - U0020408 &VAR# = Script-Variable
2022-05-06 10:34:04 - U0020408 Script-Variable = Script-Variable

Im folgenden Beispiel wird ein Wert aus dem VARA-Objekt VARA.SUB ermittelt, der wiederum den Namen von zwei Script-Variablen enthält. Die zweite und dritte Zeilen des Beispiels erstellen diese beiden Script-Variablen und legen ihren Wert fest. Zeile 4 gibt die Namen der Script-Variablen im Aktivierungsreport aus, nicht ihre Werte. Wenn Sie ihre Werte ausgeben möchten, verwenden Sie das Script-Element STR_SUB_VAR, wie in den letzten zwei Zeilen dieses Beispiels gezeigt:

:SET &VARA# = GET_VAR(VARA.SUB, "SUBVAR")
:SET &VAR1# = "Hello"
:SET &VAR2# = "World"
:PRINT "Inhalt ohne Ersetzungen: &VARA#"
:SET &VARA_SUB_VAR# = STR_SUB_VAR(&VARA#)
:PRINT "Inhalt mit Ersetzungen: &VARA_SUB_VAR#"

Ausgabe ohne und mit STR_SUB_VAR:

2022-05-06 10:34:04 - U0020408 Inhalt ohne Ersetzungen: &VAR1# &VAR2#
2022-05-06 10:34:04 - U0020408 Inhalt mit Ersetzungen: Hello World

Beispiel

Siehe auch: