ARRAY_FIRST Skalarfunktion

Die Funktion ARRAY_FIRST gibt den minimalen Array-Indexwert des Arrays zurück.

Read syntax diagramSkip visual syntax diagram ARRAY_FIRST ( array-expression )
Das Schema ist SYSIBM.
array-ausdruck
Eine SQL-Variable, ein SQL-Parameter oder eine globale Variable eines Array-Typs oder eine CAST-Spezifikation einer Parametermarke für einen Array-Typ.

Der Datentyp des Ergebnisses ist der Datentyp des Feldgruppenindex, der INTEGER für eine normale Feldgruppe ist. Wenn array-expression nicht null ist und die Kardinalität des Arrays größer als null ist, ist der Wert des Ergebnisses der minimale Array-Indexwert, der 1 für ein normales Array ist.

Das Ergebnis kann null sein. Wenn array-variable null ist oder die Kardinalität des Arrays null ist, ist das Ergebnis der Nullwert.

Beispiele

  1. Gibt den ersten Indexwert in der normalen Array-Variablen SPECIALNUMBERS an die SQL-Variable zurück E_CONSTIDX.
    SET E_CONSTIDX = ARRAY_FIRST(SPECIALNUMBERS)
    Das Ergebnis ist 1.
  2. Bei der assoziativen Array-Variablen PHONELIST mit Indexwerten und Telefonnummern: 'Home' ist '4163053745', 'Work' ist '4163053746' und 'Mom 'ist' 416-4789683 ', weist den Wert des Minimum -Index im Array der Variablen die Zeichenfolge namens Xzu.
    SET X = ARRAY_FIRST(PHONELIST)
    Der Wert 'Home' wird Xzugeordnet. Greifen Sie auf den dem Indexwert 'Home' zugeordneten Elementwert zu und ordnen Sie ihn der SQL-Variablen NUMBER_TO_CALLzu:
    SET NUMBER_TO_CALL = PHONELIST[X]