size()

Die Systemfunktion 'sysLib.size()' gibt die Anzahl der Zeilen in der angegebenen Datentabelle oder die Anzahl der Elemente in der angegebenen Feldgruppe zurück. Bei der Feldgruppe kann es sich um eine Strukturfeldgruppe oder eine dynamische Feldgruppe aus Variablen oder Datensätzen handeln.

Wenn sich der Name der Feldgruppe (Feldgruppenname) in einem Unterstrukturelement einer anderen Feldgruppe befindet, entspricht der zurückgegebene Wert der Anzahl der Elemente in dem Strukturfeld selbst, nicht der Gesamtanzahl der Vorkommen in der übergeordneten Struktur (siehe 'Beispiele' weiter unten in diesem Thema).

Syntax

  sysLib.size(Feldgruppenname ANY in)
  returns (Ergebnis INT)
Feldgruppenname
Name der Feldgruppe oder Datentabelle.
Ergebnis
Die Anzahl der Zeilen in der angegebenen Datentabelle oder die Anzahl der Elemente in der angegebenen Feldgruppe als ganze Zahl (INT).

Beispiele

Im folgenden Beispiel wird der von 'sysLib.size()' zurückgegebene Wert zur Steuerung einer Schleife verwendet:
  // Berechnung der Summe einer Feldgruppe aus Zahlen
  sum = 0;
  i = 1;
  myArraySize = sysLib.size(myArray);

  while (i <= myArraySize)
    sum = myArray[i] + sum;
    i = i + 1;
  end
Betrachten Sie als Nächstes die folgende Datensatzdefinition (Record):
  Record ExampleRecord
    10 siTop CHAR(40)[3];
      20 siNext CHAR(20)[2];
  end

Vor dem Hintergrund, dass Sie eine Datensatzvariable auf der Basis von 'ExampleRecord' erstellen, können Sie die Funktion 'sysLib.size(siNext)' verwenden, um die Anzahl der Elemente für die untergeordnete Feldgruppe zu bestimmen:

  // Zähler auf 2 setzen
  count = sysLib.size(myRecord.siTop.siNext);

Fehlerbedingungen

Wenn Sie die Funktion mit einer Feldgruppe aufrufen, für die die Anzahl der Elemente nicht angegeben ist, löst EGL eine Ausnahmebedingung vom Typ 'NullValueException' aus, wie im folgenden Beispiel:
myArray INT[];
size(myArray);

Wenn Sie eine Variable referenzieren, die keine Feldgruppe oder Datentabelle ist, tritt ein Gültigkeitsfehler auf.

Hinweise zur Kompatibilität

Tabelle 1. Hinweise zur Kompatibilität
Plattform Problem
JavaScript-Generierung Die Funktion 'sysLib.size()' wird nicht unterstützt.

Feedback