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() 함수는 소나 4.0 이전 버전부터 제공되었습니다.