ARRAY_PRIOR 스칼라 함수

ARRAY_PRIOR 함수는 지정된 배열 인덱스 인수와 관련된 배열에 대한 다음 더 작은 배열 인덱스 값을 리턴합니다.

스키마는 SYSIBM입니다.

배열 표현식

배열 유형의 SQL 변수, SQL 매개변수 또는 전역 변수 또는 배열 유형에 대한 매개변수 표시문자의 CAST 스펙입니다.

배열 인덱스

배열의 인덱스의 데이터 유형에 지정할 수 있는 값을 지정합니다. 유효한 값에는 데이터 유형에 대한 유효한 값이 포함됩니다.

결과는 지정된 array-index 값과 관련된 배열에 정의된 다음 더 작은 배열 인덱스 값입니다. array-index가 배열의 최대 인덱스 배열 값 이상인 경우, 결과는 배열에 정의된 마지막 배열 인덱스 값입니다.

함수 결과의 데이터 유형은 배열 인덱스의 데이터 유형입니다. 결과는 널(NULL)일 수 있습니다. 인수 중 하나가 널(NULL)이고, 첫 번째 인수의 카디널리티는 영(0)이거나, array-index의 값이 배열의 첫 번째 인덱스 값 이하인 경우, 결과는 널(NULL) 값입니다.

예:

일반 배열 변수 SPECIALNUMBERS의 2번째 인덱스 위치 이전의 이전 인덱스 값을 SQL 변수 PREV_CONSTIDX(으)로 리턴합니다.
```
SET PREV_CONSTIDX = ARRAY_PRIOR(SPECIALNUMBERS,2)
```
결과는 1입니다.
인덱스 값과 전화번호가 있는 연관 배열 변수 PHONELIST: 'Home'이 '4163053745', 'Work'가 '4163053746', 'Mom'이 '416-4789683'인 경우 인덱스 값 'Work' 이전 인덱스인 배열의 인덱스 값을 X(이)라는 문자열 변수에 지정합니다.
```
SET X = ARRAY_PRIOR(PHONELIST, 'Work')
```
'Mom'의 값이 X에 지정됩니다. 이전 인덱스가 인덱스 값 '집' 앞에 있는 배열에서 인덱스 값을 지정하십시오.
```
SET X = ARRAY_PRIOR(PHONELIST, 'Home')
```
널 값은 X에 지정됩니다.