Automation Engine Script-Leitfaden > Funktionelle Gliederung > Script-Aufbau und -Prozessierung > LENGTH

LENGTH

Scriptfunktion: Ermittelt die Größe eines Script-Arrays.

Syntax

LENGTH(Script-Array, [SIZE])

Syntax	Beschreibung/Format
Script-Array	Name der Script-Variable, die als Array deklariert wurde. Format: Script-Variable
SIZE	Leere Elemente am Ende des Arrays ignorieren

Rückgabewerte
Anzahl der Elemente des Script-Arrays.

Kommentare

Script-Arrays müssen mit dem Sprachmittel :DEFINE erstellt werden, wobei auch Datentyp und Anzahl der Elemente festgelegt wird. Danach kann die Größe des Arrays mit der Script-Funktion LENGTH abgefragt werden. Das Array ist dabei mit leeren Indexklammern [] anzugeben.

Die maximale Größe von Script-Arrays beträgt 99999.

Wurde das angegebene Array nicht gefunden oder eine Script-Variable angegeben, kommt es zu einem Scriptfehler.

Wird zusätzlich der Parameter SIZE spezifiziert, so wird nur die Anzahl bis zum letzten befüllten Array-Element zurückgegeben. Alle leeren Elemente am Ende des Arrays werden somit nicht mitgezählt.

Beachten Sie, dass die Ermittlung der Größe bis zum letzten befüllten Element (Parameter SIZE) nur möglich ist, wenn das Array den Datentyp "string" aufweist. Bei anderen Datentypen wird immer die gesamte Array-Größe zurückgeliefert!

Beispiele

Im folgenden Beispiel wird ein Script-Array erstellt und mit Werten aus einem Variablen-Objekt befüllt. Danach werden die Werte mit Hilfe einer Schleife ausgegeben.

: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:

Script-Sprachmittel	Beschreibung
:FILL	Speichert mehrere Werte in ein Script-Array.
FIND	Durchsucht ein Script-Array und liefert den entsprechenden Index zurück.

Script-Sprachmittel - Aktivierungsdaten

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support