Len()

Allgemeines

Die Funktion Len() dient dazu, die Länge einer Zeichenvariablen oder die Anzahl Elemente der obersten Ebene eines Arrays zu ermitteln.

Unter "Elemente der obersten Ebene eines Arrays" werden die Elemente verstanden, die mit einem einfachen Index (aDaten[nIndex]) adressiert werden können (siehe auch das letzte Beispiel). Um die Anzahl aller verschachtelten Elemente eines Arrays zu ermitteln, muss die Funktion Len() rekursiv für alle Ebenen des Arrays aufgerufen werden.

Syntax

Len(<cString|aArray>) => <nLaenge>

Parameter

<cString|aArray> gibt die zu untersuchende Einheit an. Abhängig vom Typ des Parameters wird die Anzahl Zeichen (bei Strings) bzw. die Anzahl Elemente der obersten Ebene (bei Arrays) zurückgeliefert.

Rückgabewert

<nLaenge> gibt die Anzahl Zeichen (bei Strings) bzw. Anzahl Elemente der obersten Ebene (bei Arrays) an.

Besonderheiten

Für leere Strings ("") bzw. Arrays ohne Elemente liefert Len() den Wert 0 als Ergebnis.

Querverweise

At()

RAt()

benötigte DLLs bzw. Include-Dateien

XppRT1.dll

Zuordnung

Zeichenfunktionen

Anwendungsbeispiel

aDaten := {"A", "B", {1, 2, 3, 4}}
cString := "Das ist ein Text"
? Len(cString)   => 16
? Len(aDaten)    => 3
? Len(aDaten[1]) => 1
? Len(aDaten[3]) => 4