array_contains 함수 설명
array_contains 함수는 주어진 값이 배열에 존재하는지 확인하는 기능을 제공합니다. 값이 배열에 존재하면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 배열이 특정 조건을 만족하는 값을 포함하는지 확인하려면 array_any 함수를 사용해야 합니다.
문법
array_contains(array, value, [offset], [length]);
인수 설명
| 인수 | 타입 | 설명 |
|---|---|---|
| array | Array | 값을 찾을 배열 |
| value | Any | 배열에서 찾을 값 |
| offset | Real | 배열에서의 시작 인덱스. 음수 값을 설정하면 배열의 끝에서부터 계산됩니다. |
| length | Real | 탐색할 요소의 수. 음수 값을 설정하면 배열을 거꾸로 탐색합니다. |
반환 값
- Boolean: 값이 배열에 존재하면
true, 그렇지 않으면false를 반환합니다.
예제
예제 1: 기본 사용법
var _digits_decimal = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
var _contains = array_contains(_digits_decimal, 3);
show_debug_message("The array contains the digit 3: {0}", _contains);
위 코드는 0부터 9까지의 십진수를 포함하는 _digits_decimal 배열을 정의합니다. 그런 다음 array_contains를 호출하여 값 3이 배열에 있는지 확인하고, 결과를 디버그 메시지로 출력합니다.
예제 2: 배열의 배열
var _a = [0, 1, 2];
var _b = _a;
var _array_of_arrays = [["this", "that", "another thing"], _a];
show_debug_message(array_contains(_array_of_arrays, _a));
show_debug_message(array_contains(_array_of_arrays, _b));
show_debug_message(array_contains(_array_of_arrays, [0, 1, 2]));
show_debug_message(array_contains(_array_of_arrays, ["this", "that", "another thing"]));
위 코드는 세 개의 임시 변수를 정의합니다: 배열 _a, _a를 참조하는 변수 _b, 그리고 배열 _array_of_arrays. 그런 다음 array_contains를 호출하여 4가지 다른 상황에서 결과를 디버그 메시지로 출력합니다. _array_of_arrays는 _a를 요소로 포함하고 있기 때문에 _a와 _b에 대한 호출은 true를 반환합니다. 나머지 호출은 배열이 동일한 값을 포함하더라도 서로 다른 배열이기 때문에 false를 반환합니다.
활용 예제
- 사용자 입력 확인
gml var user_input = "apple"; var fruits = ["banana", "apple", "orange"]; var is_fruit = array_contains(fruits, user_input); - 조건부 배열 탐색
gml var numbers = [1, 2, 3, 4, 5]; var has_even = array_any(numbers, function(x) { return x % 2 == 0; }); - 중복 확인
gml var items = ["item1", "item2", "item3"]; var new_item = "item2"; var is_duplicate = array_contains(items, new_item); - 특정 인덱스에서 시작하기
gml var values = [10, 20, 30, 40, 50]; var found = array_contains(values, 30, 2); // 인덱스 2부터 탐색 - 배열의 길이 제한
gml var data = [5, 10, 15, 20]; var exists = array_contains(data, 10, 0, 3); // 처음 3개 요소만 탐색