LENGTH

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
  Gibt die Größe des Script-Arrays zurück

• Script-Array
  Name der Script-Variablen, die als Array definiert wurde

• SIZE
  Ignoriert leere Elemente am Ende des Arrays
  Hinweis: Dieser Parameter gibt nur die Größe bis zum letzten gefüllten Element zurück, wenn das Array den Datentyp String verwendet. 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 Script-Fehler 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 VARA-Objekt. 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: