instanceof 함수 설명 및 활용 예제

instanceof 함수는 구조체를 생성하는 데 사용된 생성자 함수의 이름을 가져오는 데 사용됩니다. 이 구조체는 new 연산자와 함께 생성자 함수로 생성되어야 합니다. 구조체 참조 변수를 제공하면, 함수는 생성자 이름이 포함된 문자열 또는 undefined를 반환합니다.

사용 권장 사항

• 구조체의 생성자를 확인할 때는 is_instanceof를 사용하는 것이 좋습니다. 이 함수는 부모 생성자(구조체 생성자가 상속받은 생성자)도 확인할 수 있습니다.
• is_instanceof는 문자열 대신 생성자 함수 참조를 직접 사용할 수 있습니다.

함수 동작

• 구조체 리터럴(생성자 함수를 사용하지 않고 생성된 구조체)을 전달하면 문자열 "struct"를 반환합니다.
• 객체 인스턴스 내에서 self 키워드를 전달하면 "instance"를 반환합니다.
• 생성자 함수가 스크립트에서 생성되지 않은 경우, 반환된 생성자 이름에는 추가 텍스트가 포함됩니다. 예를 들어, Object1의 Create 이벤트에서 생성된 test_constructor라는 생성자는 "test_constructor_gml_Object_Object1_Create_0"로 반환됩니다. 이를 피하려면 생성자를 스크립트에서 생성해야 합니다.
• 이 함수는 구조체 참조가 약한 참조인지 여부를 확인하는 데도 사용할 수 있으며, 이 경우 함수는 생성자 이름 대신 문자열 "weakref"를 반환합니다.

문법

instanceof(struct_id);

인수 설명

활용 예제

생성자 함수 정의

먼저 구조체의 생성자로 사용할 함수를 정의합니다.

function init_struct(_a, _b, _c) constructor {
    a = _a;
    b = _b;
    c = _c;
}

구조체 생성

이 함수를 사용하여 구조체를 생성하고, 함수의 인수 값으로 변수를 설정합니다.

mystruct = new init_struct(10, 100, "Hello World");

생성자 이름 가져오기

사용된 생성자 함수의 이름을 가져오는 방법은 다음과 같습니다.

var _name = instanceof(mystruct);
if (is_string(_name)) {
    show_debug_message(_name);
}

이 코드는 생성자 함수의 이름인 "init_struct"를 출력 로그에 인쇄합니다.

추가 활용 예제

1. 약한 참조 확인

var weak_ref = weak_ref_create(mystruct);
var ref_type = instanceof(weak_ref);
show_debug_message(ref_type); // "weakref" 출력

1. 부모 생성자 확인

function parent_constructor() {
    // 부모 생성자 로직
}

function child_constructor() constructor {
    // 자식 생성자 로직
}

var child = new child_constructor();
var parent_check = is_instanceof(child, parent_constructor);
show_debug_message(string(parent_check)); // true 또는 false 출력

1. 생성자 이름에 대한 추가 정보

function another_constructor() constructor {
    // 또 다른 생성자 로직
}

var another_struct = new another_constructor();
var another_name = instanceof(another_struct);
show_debug_message(another_name); // "another_constructor" 출력

이와 같이 instanceof 함수는 구조체의 생성자 정보를 확인하는 데 유용하게 사용될 수 있습니다.