sumarray()

配列に含まれる数値要素をすべて加算した合計を返します。

構文

パラメーター

ARRAY

合計を計算する配列。

説明

sumarray() 関数は配列の各要素を順に処理し、数値型の要素の合計を計算して返します。数値でない要素や null 要素は計算から除外します。

戻り値の型は入力値の型によって異なります。要素が byte、int、long、short 型のプリミティブ配列の場合は64ビット整数（long）を返し、double、float 型のプリミティブ配列、リスト（List）、またはオブジェクト配列（数値を含む）の場合は64ビット実数（double）を返します。

入力値が null の場合は null を返します。配列のすべての要素が数値でないか null の場合は 0（または 0.0）を返します。

エラーコード

該当なし

使用例

1. 整数配列の合計を計算

   json "{}" | eval sum = sumarray(array(1, 2, 3, 4, 5))
   | # sum: 15.0
   

2. 数値でない要素と null を除いて合計を計算

   json "{}" | eval sum = sumarray(array(1, 2, 3, null, "a", 4, 5))
   | # sum: 15.0
   

3. すべての要素が数値でないか null の場合

   json "{}" | eval sum = sumarray(array(null, null, "a", "b"))
   | # sum: 0.0
   

4. null 入力

   json "{}" | eval sum = sumarray(null)
   | # sum: null
   

互換性

sumarray() 関数は、Sonar 4.0以前のバージョンから提供されています。