ARRAY_LAST スカラー関数

ARRAY_LAST 関数は、配列の最大の配列指標値を戻します。

構文図を読む構文図をスキップする ARRAY_LAST ( array-expression )
スキーマは SYSIBM です。
array-expression
配列タイプの SQL 変数、SQL パラメーター、またはグローバル変数か、配列タイプへのパラメーター・マーカーの CAST 指定。

結果のデータ・タイプは、配列指標のデータ・タイプで、通常配列の場合は INTEGER です。array-expression が NULL ではなく、配列のカーディナリティーがゼロより大きいと、結果の値は最大の配列指標値で、通常配列の場合は配列のカーディナリティーです。

結果は NULL 値になることがあります。array-variable が NULL か、配列のカーディナリティーがゼロである場合、結果は NULL 値になります。

  1. 通常配列変数 SPECIALNUMBERS 内の最後の指標値を SQL 変数 PI_CONSTIDX に戻します。
    SET PI_CONSTIDX = ARRAY_LAST(SPECIALNUMBERS)
    結果は、10 になります。
  2. 連想配列変数 PHONELIST があり、その指標値と電話番号は、'Home' が '4163053745'、'Work' が '4163053746'、'Mom' が '4164789683' であるとします。この配列内の最大の指標値を、X という名前の文字ストリング変数に割り当てます。
    SET X = ARRAY_LAST(PHONELIST)
    X には値 'Work' が割り当てられます。次は、指標値 'Work' を関連付けられたエレメント値を取得し、SQL 変数 NUMBER_TO_CALL に割り当てます。
    SET NUMBER_TO_CALL = PHONELIST[X]