배열 함수

배열과 관련된 몇 가지 함수가 있습니다. 이러한 함수들은 코드에서 유연성을 제공하며, 게임을 만들 때 더 기능적이고 동적인 배열을 생성할 수 있도록 도와줍니다.

기본 배열 함수

고급 배열 함수

확장 배열 함수

콜백 메서드

콜백 메서드는 array_foreach와 같은 배열 함수에 전달됩니다. GameMaker는 주어진 배열의 각 요소에 대해 콜백 메서드를 실행합니다. 배열의 각 요소에 대해 두 개의 인수를 콜백 메서드에 전달합니다:

• 배열 요소의 값
• 배열 요소의 인덱스

콜백 메서드에서 이러한 인수를 사용하여 반환 값을 계산할 수 있습니다. 예를 들어, array_map과 같은 함수에서 필요할 수 있습니다. 콜백 메서드가 각 요소에 대해 반환하는 값에 따라 결과 값이나 수정된 배열이 반환됩니다. 그러나 _ext 함수 중 하나를 사용하는 경우 원래 배열이 수정됩니다.

프레디케이트 메서드

콜백 메서드가 true 또는 false만 반환해야 할 때, 이를 프레디케이트 메서드라고 합니다. 프레디케이트는 배열의 요소가 조건을 만족하는지 여부를 판단하는 데 사용됩니다.

예제: 프레디케이트

배열에 문자열 "apple"이 포함되어 있는지 확인하는 프레디케이트 메서드를 만들어 보겠습니다. 이를 위해 array_any 함수를 사용합니다:

var _array = ["apple", "banana", "coconut", "dragonfruit"];
var _contains_apple = array_any(_array, function(_val, _ind) {
    return _val == "apple";
});
show_debug_message(_contains_apple); // 1 (true) 출력

우리의 프레디케이트 메서드는 _val == "apple"을 확인하고 결과를 반환합니다. 배열의 요소 중 하나라도 이 조건이 참이면 array_any는 true를 반환합니다.

기본적으로 프레디케이트 메서드는 배열의 모든 요소에서 실행되지만, 대부분의 고급 배열 함수는 두 개의 추가 매개변수인 offset과 length를 받습니다.

오프셋과 길이

offset과 length 매개변수를 사용하면 함수가 배열의 어떤 부분을 살펴볼지, 어떤 방향으로 진행할지를 결정할 수 있습니다 (앞으로 또는 뒤로).

• offset은 함수가 배열에서 작업을 시작하는 0 기반 인덱스입니다.
• offset은 음수일 수 있으며, 이 경우 배열의 끝에서 시작합니다. 예를 들어, -1은 배열의 마지막 요소를 참조하고, -2는 두 번째 마지막 요소를 참조합니다.
• length는 offset에서 시작하여 배열에서 확인할 요소의 수입니다. length도 음수일 수 있으며, 이 경우 함수는 뒤로 작업합니다. 예를 들어, offset이 3이고 length가 3이면 요소 3, 4, 5가 포함됩니다. length가 -3이면 요소 3, 2, 1이 포함됩니다.

infinity 또는 -infinity를 length로 사용하여 배열의 끝이나 시작까지 탐색할 수 있습니다. 함수가 수정된 배열을 반환하는 경우, 작업된 요소만 반환되며, 작업된 순서대로 반환됩니다. 예를 들어, offset이 3이고 length가 3인 경우, 요소 3, 4, 5가 작업되고 새로운 배열로 반환되며, 나머지 요소는 버려집니다.