ARRAY_2_STRING
Script-Funktion: Wandelt ein Script-Array in einen String um.
Syntax
ARRAY_2_STRING (Script-Array, [Trennzeichen,] [Bereich])
|
Syntax |
Beschreibung/Format |
|---|---|
|
Script-Array |
Variablenname des Arrays |
| Trennzeichen | Ein oder mehrere Zeichen, die in den String zwischen den Array-Elementen eingefügt werden sollen. Format: Script-Variable oder Script-Literal |
| Flächendiagramm |
Bereich des Arrays Zulässige Werte: "ALL" oder "FILLED" (Standard) "ALL" = Alle Elemente des Arrays verwenden |
|
Rückgabewerte |
|---|
|
String, der die Elemente des Arrays enthält. |
Die Script-Funktion liefert die Elemente eines Script-Arrays in Form eines Strings zurück. Dabei muss der Variablenname des Arrays mit den leeren Indexklammern [] angegeben werden.
Zusätzlich können ein oder mehrere Trennzeichen festgelegt werden, welche die Elemente im Ergebnis-String voneinander trennen.
Sie können außerdem festlegen, ob alle Elemente oder nur diejenigen bis zum letzten befüllten Element verwendet werden sollen. Im letzteren Fall werden leere Elemente am Ende des Arrays ignoriert.
Beispiele
In folgendem Beispiel-Script wird ein Array erstellt und mit Einträgen eines VARA-Objekts befüllt. Anschließend wird das Array in einen String umgewandelt und dieser im Aktivierungsreport ausgegeben. Als Trennzeichen für die Array-Elemente wird ein Bindestrich verwendet.
:DEFINE &ARRAY#, string, 5
:DEFINE &STR#, string
:FILL &ARRAY#[] = GET_VAR(VARA.STATIC.TEST,"KEY01")
:SET &STR# = ARRAY_2_STRING(&ARRAY#[],"-",FILLED)
:P "&STR#"
Siehe auch: