배열에 원소 추가

항목	값
화면 이름	Array add
식별자	`arrayAddV1`
지원 실행 방식	Batch, Faster, Streaming
범주	배열 (Array)
반환 자료형	`Array<T>`

배열의 지정한 인덱스에 값을 추가합니다.

입력 인자

이름	지정 여부	자료형	의미와 조건
`Array`	필수	`Expression<Array<T>>`	원소를 추가할 배열입니다.
`Index`	필수	`Expression<Integer>`	새 원소를 삽입할 위치입니다. 첫 원소의 위치는 1입니다.
`Value`	필수	`Expression<T>`	배열에 추가할 원소입니다.

자료형 변수의 범위

T는 AnyType 범위의 자료형을 받습니다.

입출력 예시

예시 1: 기본 동작

인자 값:

Array: numbers
Index: 1
Value: 1

numbers	출력
[ 3, 5 ]	[ 1, 3, 5 ]
[ 2 ]	[ 1, 2 ]
[ ]	[ 1 ]

예시 2: null 처리, ANSI 모드 켜짐

인자 값:

Array: numbers
Index: index
Value: value

numbers	value	index	출력
null	1	1	null
[ 1 ]	null	1	[ null, 1 ]
[ 1 ]	1	null	null

예시 3: null 처리, ANSI 모드 꺼짐

인자 값:

Array: numbers
Index: index
Value: value

numbers	value	index	출력
null	1	1	null
[ 1 ]	null	1	[ null, 1 ]
[ 1 ]	1	null	[ 1 ]

예시 4: 경계 조건

배열 길이보다 큰 인덱스에는 원소를 끝에 추가합니다.

인자 값:

Array: numbers
Index: index
Value: value

numbers	value	index	출력
[ 1, 2 ]	3	3	[ 1, 2, 3 ]
[ 1 ]	2	3	[ 1, null, 2 ]
[ ]	1	3	[ null, null, 1 ]
[ 3, 5 ]	1	10	[ 3, 5, null, null, null, null, null, null, null, 1 ]

예시 5: 경계 조건

음수 인덱스는 배열 끝에서 셉니다.

인자 값:

Array: numbers
Index: index
Value: value

numbers	value	index	출력
[ 1, 3 ]	2	-1	[ 1, 2, 3 ]
[ 2, 3 ]	1	-2	[ 1, 2, 3 ]
[ 2, 3 ]	1	-3	[ 1, null, 2, 3 ]
[ 2 ]	1	-1	[ 1, 2 ]
[ 2 ]	1	-2	[ 1, null, 2 ]
[ 2 ]	1	-3	[ 1, null, null, 2 ]
[ ]	1	-1	[ 1, null ]
[ ]	1	-2	[ 1, null, null ]
[ ]	1	-3	[ 1, null, null, null ]