Array-Variablen

Außer normalen skalaren Variablen unterstützt NZPLSQL auch Array-Variablen. Verwenden Sie die folgende Syntax, um eine Array-Variable zu deklarieren:
name VARRAY(size) OF type;
Für alle Elemente des Arrays wird als deklarierter Typ anfangs der SQL-Wert NULL festgelegt. Führen Sie Folgendes aus, um einem Element einen Wert zuzuweisen:
name(idx) := value;
Diese Syntax löst eine Ausnahmebedingung aus, wenn der Index (idx) außerhalb des gültigen Bereichs liegt. Folgende Methoden werden unterstützt:
name.EXTEND(size)
name.COUNT
name.TRIM(size)

Durch die Methode EXTEND wird das Array um die angegebene Größe erweitert. Wenn Größe nicht angegeben wird, lautet der Standardwert 1.

Mit COUNT wird die Anzahl der Elemente im Array zurückgegeben.

Mit TRIM werden die letzten Größe Elemente im Array gelöscht (Standardwert ist 1). Durch TRIM und EXTEND wird eine Ausnahmebedingung ausgelöst, falls Größe außerhalb des gültigen Bereichs liegt.

Arrayreferenzen sind nahezu überall dort zulässig, wo Variablenreferenzen zulässig sind; es gibt allerdings folgende Ausnahmen:
  • Als Argument für RAISE
  • Als Variable INTO
  • Als Variable in einer For-Schleife (FOR LOOP)
  • Als Bestandteil eines Standardwerts