array_contains_ext 함수 설명
array_contains_ext 함수는 주어진 배열(또는 그 일부)에 특정 값이 포함되어 있는지 확인하는 기능을 제공합니다. matchAll 인자는 배열에 모든 값이 존재해야 하는지(true) 아니면 그 중 하나만 존재해도 되는지(false)를 결정합니다. values 배열은 중복 값을 포함할 수 있습니다. matchAll이 활성화되면, 원래 배열에서 특정 값이 몇 번 나타나는지를 정확하게 확인할 수 있습니다. 특정 조건을 만족하는 값을 포함하는지 확인하려면 array_any를 사용하세요.
함수 문법
array_contains_ext(array, values, [matchAll], [offset], [length]);
인자 설명
| 인자 | 타입 | 설명 |
|---|---|---|
| array | Array | 값을 찾을 배열입니다. |
| values | Array | 찾을 값을 포함하는 배열입니다. 중복 값을 추가할 수 있습니다. |
| matchAll | Boolean | 배열에 모든 값이 존재해야 하는지(true) 또는 그 중 하나만 필요인지(false) 결정합니다. 기본값은 false입니다. |
| offset | Real | 배열에서의 시작 인덱스입니다. 기본값은 0입니다. 음수 값을 설정하면 배열의 끝에서부터 계산합니다. |
| length | Real | 탐색할 요소의 수입니다. 기본값은 array_length() - 1입니다. 음수 값은 배열을 역순으로 탐색합니다. |
반환값
- Boolean: 조건에 따라 true 또는 false를 반환합니다.
활용 예제
예제 1: 배열에 특정 값이 있는지 확인하기
hand = ["1", "1", "4", "J", "J", "Q", "7", "10", "K", "8", "7", "8", "5"];
var _high_cards = ["A", "K", "Q", "J"];
var _any_high_cards = array_contains_ext(hand, _high_cards);
show_debug_message(_any_high_cards);
위 코드는 hand 배열을 생성하고, "하이 카드"를 정의하는 _high_cards 배열을 만듭니다. 그런 다음 array_contains_ext를 사용하여 hand 배열에 이 카드 중 하나가 있는지 확인하고 결과를 _any_high_cards 변수에 저장합니다.
예제 2: 배열에 모든 값이 있는지 확인하기
inputs = ["left", "right", "left", "left", "up", "down", "right"];
var _required_inputs = ["left", "left", "left"];
var _input_valid = array_contains_ext(inputs, _required_inputs, true);
show_debug_message(_input_valid);
위 코드는 입력 시퀀스를 포함하는 inputs 배열을 생성하고, 유효한 시퀀스를 만드는 입력을 포함하는 _required_inputs 배열을 만듭니다. 그런 다음 array_contains_ext를 호출하여 inputs 배열을 검증하고 결과를 _input_valid 변수에 저장합니다.
예제 3: 특정 조건을 만족하는 값 확인하기
data = [1, 2, 3, 4, 5, 6];
var check_values = [2, 4];
var contains_any = array_contains_ext(data, check_values);
show_debug_message(contains_any);
이 예제에서는 data 배열에 1부터 6까지의 숫자가 포함되어 있습니다. check_values 배열에 2와 4가 포함되어 있으며, array_contains_ext를 사용하여 data 배열에 이 값 중 하나가 있는지 확인합니다.
예제 4: 배열의 특정 부분만 확인하기
numbers = [10, 20, 30, 40, 50];
var search_values = [20, 30];
var contains_all = array_contains_ext(numbers, search_values, true, 0, 5);
show_debug_message(contains_all);
위 코드는 numbers 배열에서 20과 30이 모두 포함되어 있는지를 확인합니다. offset과 length를 사용하여 배열의 특정 부분만 탐색할 수 있습니다.