Die Script-Funktion LENGTH ermittelt die Größe eines Script-Arrays. Die Funktion gibt die Anzahl der Elemente im Script-Array oder die Anzahl der gefüllten Array-Elemente zurück.
Syntax
LENGTH (script array [,SIZE])
Parameter
- LENGTH
Liefert die Größe eines Script-Arrays - script array
Name der Script-Variable, die als Array definiert wurde - SIZE
Ignoriert leere Elemente am Ende des Arrays
Hinweis: Dieser Parameter gibt nur dann die Größe bis zum letzten gefüllten Element zurück, wenn das Array den Datentyp „string“ hat. Alle anderen Datentypen geben immer die gesamte Array-Größe zurück.
Hinweis: Die maximale Größe von Script-Arrays beträgt 99999. Weitere Informationen zu Script-Arrays finden Sie unter Arrays.
Wichtig! Ein Scriptfehler tritt auf, wenn das angegebene Array nicht gefunden werden kann oder wenn Sie eine Script-Variable anstelle eines Script-Arrays angeben. Stellen Sie sicher, dass Sie leere eckige Klammern verwenden, um Ihr Array anzugeben.
Beispiel
Das folgende Beispiel erstellt ein Script-Array und füllt das Array mit Werten aus einem Variablenobjekt. Das Script verwendet eine Schleife, um die Ergebnisse in den Aktivierungsreport zu schreiben.
:DEFINE &ARRAY#, string, 5
:SET &LEN# = LENGTH(&ARRAY#[])
:SET &VAR# = 1
:FILL &ARRAY#[] = GET_VAR(VARA1, ARRAY)
:WHILE &VAR# LE &LEN#
:PRINT "Element &VAR# = &ARRAY#[&VAR#]"
:SET &VAR# = &VAR# + 1
:ENDWHILE
Siehe auch: