array_get_index 함수 설명 및 활용 예제
array_get_index 함수는 주어진 배열에서 특정 값의 인덱스를 가져오는 기능을 제공합니다. 선택적으로 오프셋과 길이 매개변수를 제공하여 검색할 배열의 범위를 정의할 수 있습니다. 값이 발견되지 않으면 -1이 반환됩니다. 조건을 만족하는 첫 번째 배열 요소의 인덱스를 찾고 싶다면 array_find_index를 사용하세요.
문법
array_get_index(array, value, [offset], [length]);
매개변수 설명
| 매개변수 | 타입 | 설명 |
|---|---|---|
| array | Array | 값을 찾을 배열 |
| value | Any | 찾고자 하는 값 |
| offset | Real | 배열에서의 오프셋 또는 시작 인덱스. 음수 값을 설정하면 배열의 끝에서부터 계산됩니다. |
| length | Real | 탐색할 요소의 수. 음수 값을 설정하면 배열을 거꾸로 탐색합니다. |
반환값
- Real: 값이 발견되면 첫 번째 발생의 인덱스, 발견되지 않으면 -1을 반환합니다.
예제
예제 1
var _array = array_create(100, 1);
_array[7] = 13;
var _index = array_get_index(_array, 13);
show_debug_message("The value 13 was found at index {0}", _index);
위 코드는 크기가 100인 임시 배열 _array를 생성하고 인덱스 7에 13을 설정합니다. 그런 다음 array_get_index를 사용하여 값 13의 인덱스를 찾고, 해당 인덱스를 디버그 메시지로 출력합니다.
예제 2
var _array = ["a", "b", "c", "d", "e", "d", "c", "b", "a"];
var _pos1 = array_get_index(_array, "d"); // 3
var _pos2 = array_get_index(_array, "d", 6); // -1
var _pos3 = array_get_index(_array, "d", -1, -infinity); // 5
위 코드에서는 문자 집합으로 초기화된 배열 _array에서 문자 "d"의 위치를 세 번 조회합니다. 각 호출에서 오프셋과 길이에 대한 서로 다른 값을 사용하여 결과를 확인합니다.
활용 예제
예제 3: 배열에서 특정 값 찾기
var myArray = [10, 20, 30, 40, 50];
var index = array_get_index(myArray, 30); // 2
예제 4: 음수 오프셋 사용하기
var myArray = [1, 2, 3, 4, 5];
var index = array_get_index(myArray, 2, -3); // 1
예제 5: 길이 매개변수 사용하기
var myArray = [5, 10, 15, 20, 25];
var index = array_get_index(myArray, 15, 0, 3); // -1
예제 6: 배열의 끝에서부터 찾기
var myArray = ["apple", "banana", "cherry", "date"];
var index = array_get_index(myArray, "banana", -1, -infinity); // 1
이와 같이 array_get_index 함수를 사용하여 배열에서 특정 값을 찾고, 다양한 매개변수를 활용하여 검색 범위를 조정할 수 있습니다.