배열에 값 삽입하기 (array_insert)
array_insert 함수는 배열의 특정 위치에 값(또는 여러 값)을 삽입하는 기능을 제공합니다. 이 함수는 배열, 삽입할 인덱스(위치), 그리고 최소 하나의 값을 인자로 받습니다. 추가적인 값을 제공할 수도 있으며, 이 값들은 주어진 인덱스부터 순차적으로 배열에 삽입됩니다. 만약 주어진 인덱스가 배열의 길이를 초과하면, 값들은 해당 인덱스에 추가되고, 마지막 값과 삽입된 값 사이의 빈 슬롯은 기본값인 0으로 설정됩니다.
문법
array_insert(variable, index, value, [value], [value], [etc...]);
인자 설명
| 인자 | 타입 | 설명 |
|---|---|---|
| variable | Array | 배열을 담고 있는 변수 |
| index | Real | 값을 삽입할 배열의 인덱스(위치). 음수 인덱스도 지원되며 배열의 끝에서부터 계산됩니다. -1은 마지막 요소, -2는 마지막에서 두 번째 요소를 의미합니다. |
| value | Any | 삽입할 값 |
| [value] | Any | 추가로 삽입할 값 |
반환값
N/A
예제
예제 1: 단일 값 삽입
array = [1, 2, 3, 5];
var _missing_value = 4;
array_insert(array, 3, _missing_value);
show_debug_message(array);
위 코드는 배열 array의 인덱스 3에 누락된 값을 삽입합니다. 삽입 후 배열의 내용을 디버그 메시지로 출력합니다.
예제 2: 여러 값 삽입
var _array = ["G", "a", "k", "e", "r"];
array_insert(_array, 2, "m", "e", "M", "a");
show_debug_message(string_join_ext("", _array));
위 코드는 임시 배열 _array를 생성한 후, 인덱스 2에 여러 값을 삽입합니다. 이후 string_join_ext를 호출하여 배열의 문자들을 연결하고, 결과 문자열을 디버그 메시지로 출력합니다.
활용 예제
예제 3: 배열의 시작에 값 삽입
var my_array = [2, 3, 4];
array_insert(my_array, 0, 1);
show_debug_message(my_array);
예제 4: 배열의 끝에 값 삽입
var my_array = [10, 20, 30];
array_insert(my_array, 3, 40);
show_debug_message(my_array);
예제 5: 음수 인덱스를 사용하여 값 삽입
var my_array = [5, 10, 15];
array_insert(my_array, -1, 12);
show_debug_message(my_array);
예제 6: 빈 배열에 값 삽입
var my_array = [];
array_insert(my_array, 0, 1, 2, 3);
show_debug_message(my_array);
이와 같이 array_insert 함수를 활용하여 다양한 방식으로 배열에 값을 삽입할 수 있습니다.