Script-Funktion: Konvertiert ein Script-Array in eine Zeichenfolge.
Syntax
ARRAY_2_STRING (Script Array, [Separator,] [Area])
|
Syntax |
Beschreibung/Format |
|---|---|
|
Script Array |
Variablenname des Arrays |
| Separator | Ein oder mehrere Zeichen, die in der Zeichenkette zwischen den Array-Elementen eingefügt werden sollen. Format: Script-Variable oder Script-Literal |
| Area |
Bereich des Arrays Erlaubte Werte: "ALL" oder "FILLED" (Standardwert) "ALL" = Alle Elemente des Arrays verwenden |
|
Rückgabewerte |
|---|
|
Zeichenkette, welche die Elemente des Arrays enthält. |
Die Script-Funktion liefert die Elemente eines Script-Arrays in Form einer Zeichenkette zurück. Dabei ist der Variablenname des Arrays, inklusive der leeren Indexklammern [], anzugeben.
Zusätzlich können ein oder mehrere Trennzeichen festgelegt werden, welche die Elemente in der resultierenden Zeichenkette voneinander trennen.
Sie haben außerdem die Möglichkeit zu bestimmen, ob alle Elemente oder nur jene 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 Variablen-Objektes befüllt. Anschließend wird das Array in eine Zeichenkette umgewandelt und diese 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: