TRIM_ARRAY スカラー関数

TRIM_ARRAY 関数は、配列の末尾からエレメントを削除します。

構文図を読む構文図をスキップする TRIM_ARRAYARRAY_TRIM ( array-expression ,numeric-expression )

スキーマは SYSIBM です。

array-expression
通常配列タイプの SQL 変数、SQL パラメーター、またはグローバル変数か、通常配列タイプへのパラメーター・マーカーの CAST 指定。 連想配列データ・タイプを指定することはできません (SQLSTATE 42884)。
numeric-expression
配列の終わりから切り取られるエレメントの数を指定します。numeric-expression は、INTEGER へキャストできる値を持つ、任意の数値データ・タイプにすることができます。 numeric-expression の値は、0 と、array-expression のカーディナリティーとの間でなければなりません (SQLSTATE 2202E)。

結果

この関数が返す値の配列タイプは array-expression と同じですが、カーディナリティーは INTEGER(numeric-expression) の値の分だけ減少します。

結果は NULL になる可能性があります。 いずれかの引数が NULL である場合、その結果は NULL 値になります。

規則

  • TRIM_ARRAY 関数は、連想配列ではサポートされていません (SQLSTATE 42884)。
  • TRIM_ARRAY 関数を使用できるのは、配列がサポートされているコンテキスト内の割り当てステートメントの右辺だけです (SQLSTATE 42884)。

例

  1. 例 1: 配列変数 RECENT_CALLS の最後のエレメントを除去します。 
       SET RECENT_CALLS = TRIM_ARRAY(RECENT_CALLS, 1)
  2. 例 2: 配列変数 SPECIALNUMBERS から SQL 配列変数 EULER_CONST へ、最初の 2 つのエレメントのみ割り当てます。 
    SET EULER_CONST = TRIM_ARRAY(SPECIALNUMBERS, 8)
    結果として、EULER_CONST が 2 つのエレメントのある配列に割り当てられます。最初のエレメント値は 2.71828183 で、2 番目のエレメント値は NULL 値です。