배열 비교 함수: array_equals

이 문서는 array_equals 함수에 대해 설명합니다. 이 함수는 두 개의 배열이 동일한지(같거나 동등한지) 확인합니다. 두 배열을 입력으로 주면, 함수는 두 배열이 같으면 true를, 그렇지 않으면 false를 반환합니다. 이 검사는 재귀적으로 수행되므로, 중첩된 배열도 확인합니다.

사용 주의 사항

array_equals는 두 배열이 동일한지 확인하는 것이 아니라, 두 배열이 같은 값을 가지고 있는지를 확인합니다. 예를 들어, 다음과 같은 코드가 있습니다:

var a = [1, 2, 3, 4];
var b = [1, 2, 3, 4];
if (a == b) {
    show_debug_message("이 메시지는 출력되지 않습니다. a와 b는 같은 배열을 참조하지 않기 때문입니다.");
}
if (array_equals(a, b)) {
    show_debug_message("이 메시지는 출력됩니다. 두 배열은 동일한 값을 가지고 있습니다.");
}

배열의 요소가 구조체나 인스턴스에 대한 참조를 저장하는 경우, 함수는 그 내용을 비교하지 않고, 두 참조가 메모리에서 같은 것을 가리키는지 확인합니다.

주의할 점

일부 상수는 자기 자신과 같지 않을 수 있으며, 이로 인해 함수가 실패할 수 있습니다. 예를 들어:

if (array_equals([NaN], [NaN])) {
    show_debug_message("이 메시지는 출력되지 않습니다. NaN은 자기 자신과 같을 수 없습니다.");
}

함수 문법

array_equals(var1, var2);

인수 설명

반환값

• Boolean: 두 배열이 같으면 true, 아니면 false

활용 예제

예제 1: 기본 사용법

var _array1 = [1, 2, 3, 4, 5];
var _array2 = [1, 2, 5, 4, 3];
if (!array_equals(_array2, _array1)) {
    var _len = array_length(_array1);
    array_copy(_array2, 0, _array1, 0, _len);
}
show_debug_message(_array1);
show_debug_message(_array2);

위 코드는 두 배열이 동일한 값을 가지고 있는지 확인합니다. 만약 그렇지 않다면, _array1의 모든 내용을 _array2로 복사합니다. 복사 후 두 배열의 내용을 디버그 메시지로 출력합니다.

예제 2: 중첩 배열 및 참조

var _the_struct = {a: 84, b: 38};
var _array1 = [_the_struct, 5, "hello", ["this", "that"]];
var _array2 = [_the_struct, 5, "hello", ["this", "that"]];
var _array3 = [{a: 84, b: 38}, 5, "hello", ["this", "that"]];
show_debug_message($"_array1 equals _array2: {array_equals(_array1, _array2)}");
show_debug_message($"_array1 equals _array3: {array_equals(_array1, _array3)}");

위 코드는 다른 배열과 구조체를 포함하는 배열 간의 비교를 보여줍니다. 세 개의 배열 _array1, _array2, _array3가 정의되어 있으며, 각각 동일한 변수를 포함하고 있습니다. _array1과 _array2는 같은 구조체를 참조하고 있지만, _array3는 그렇지 않습니다. 이후 두 배열을 array_equals를 사용하여 비교하고 결과를 디버그 메시지로 출력합니다.