STR_SUBSTITUTE_VAR, STR_SUB_VAR
Script-Funktion: Ersetzt Script-Variablennamen durch ihre Werte.
Syntax
STR_SUB[STITUTE]_VAR (Variablen)
|
Syntax |
Beschreibung/Format |
|---|---|
|
Variablen |
Script-Variable oder String, die einen oder mehrere Variablennamen enthalten. |
|
Rückgabewert |
|---|
|
Stringmit den Werten der Script-Variablen |
Die Script-Variable STR_SUB_VAR bietet die Möglichkeit einen oder mehrere Namen von Script-Variablen, welche wiederum als Stringin einer anderen Script-Variablen gespeichert sind, durch den tatsächlichen Variablen-Wert zu ersetzen. Die folgenden Beispiele sollen das Verhalten verdeutlichen.
Tipp: Verwenden Sie die Script-Funktion GET_PROCESS_LINE mit dem Parameter STR_SUB[STITUTE]_VAR, um die gleiche Art von Ersetzungen in Datensequenzzeilen durchzuführen. Weitere Informationen finden Sie unter GET_PROCESS_LINE.
Beispiele
In folgendem Beispiel wird der Name einer Script-Variablen (&VAR#) in einer andere Variablen gespeichert (&VAR_NOSUB#), indem das Zeichen & doppelt verwendet wird.
Wird &VAR_NOSUB# ausgegeben, so wird der Name der Script-Variablen &VAR# in den Aktivierungsreport geschrieben. Das Script-Element STR_SUB_VAR dient dazu, diesen Namen durch den Wert der Variable zu ersetzen.
:SET &VAR# = "Script-Variable"
:SET &VAR_NOSUB# = "&&VAR# = &VAR#"
:PRINT &VAR_NOSUB#
:SET &VAR_SUB# = STR_SUB_VAR(&VAR_NOSUB#)
:PRINT &VAR_SUB#
Ausgabe im Aktivierungsreport:
2011-05-06 10:34:04 - U0020408 &VAR# = Script-Variable
2011-05-06 10:34:04 - U0020408 Script-Variable = Script-Variable
Im zweiten Beispiel wird ein Wert aus dem VARA-Objekt VARA.SUB ermittelt, der wiederum den Namen von zwei Script-Variablen enthält. Diese zwei Script-Variablen werden anschließend erstellt und gesetzt.
Die Script-Variablennamen werden nur dann in den Report geschrieben, wenn der Wert des VARA-Objekts direkt ausgegeben wird. Sie werden nicht durch ihre Werte ersetzt.
Um die Namen der zwei Script-Variablen durch deren Wert zu ersetzen, wird das Script-Element STR_SUB_VAR verwendet.
: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:
2011-05-06 10:34:04 - U0020408 Inhalt ohne Ersetzungen: &VAR1# &VAR2#
2011-05-06 10:34:04 - U0020408 Inhalt mit Ersetzungen: Hello World
Beispiel
Siehe auch: