DS 리스트 마킹 함수 설명
ds_list_mark_as_list 함수는 이전에 생성된 DS 리스트 내의 특정 위치를 다른 DS 리스트를 포함하고 있음을 "마킹" (또는 "플래그")하는 기능을 제공합니다. 이 기능은 JSON 문자열을 인코딩할 때 필요하며, 데이터 구조를 중첩할 때도 유용합니다. 마킹된 항목은 부모 DS 리스트가 파괴될 때 자동으로 가비지 수집(제거)됩니다. 따라서 "부모" 리스트를 파괴하기 전에 마킹된 데이터 구조를 개별적으로 제거할 필요가 없습니다.
그러나 리스트 위치를 개별적으로 삭제하면 포함된 DS 리스트는 가비지 수집되지 않으므로, 부모 리스트에서 항목을 삭제하기 전에 적절한 DS 리스트 제거 함수를 호출해야 합니다. 또한, ds_list_clear 함수를 호출하면 마킹된 리스트 항목도 함께 제거됩니다.
문법
ds_list_mark_as_list(id, pos);
인수 설명
| 인수 | 유형 | 설명 |
|---|---|---|
| id | DS 리스트 | 마킹할 리스트의 핸들 |
| pos | 실수 | 마킹할 리스트 내의 위치 |
반환 값
- DS 리스트 또는 -1 (실패 시)
예제
var j_list = ds_list_create();
var sub_list = ds_list_create();
ds_list_add(sub_list, health);
ds_list_add(sub_list, lives);
ds_list_add(sub_list, score);
ds_list_add(j_list, sub_list);
ds_list_mark_as_list(j_list, 0);
위 코드는 두 개의 DS 리스트를 생성한 후, 하나에 전역 변수의 다양한 값을 추가합니다. 이 리스트는 두 번째 리스트에 추가되고, 나중에 올바르게 인코딩될 수 있도록 해당 위치가 마킹됩니다.
활용 예제
예제 1: 중첩 데이터 구조 생성
var main_list = ds_list_create();
var nested_list = ds_list_create();
ds_list_add(nested_list, "Item 1");
ds_list_add(nested_list, "Item 2");
ds_list_mark_as_list(main_list, 0);
예제 2: JSON 인코딩
var data_list = ds_list_create();
var user_info = ds_list_create();
ds_list_add(user_info, "John Doe");
ds_list_add(user_info, 30);
ds_list_mark_as_list(data_list, 0);
var json_string = json_encode(data_list);
예제 3: 리스트 클리어 후 마킹된 항목 제거
var clear_list = ds_list_create();
var temp_list = ds_list_create();
ds_list_add(temp_list, "Temp Data");
ds_list_mark_as_list(clear_list, 0);
ds_list_clear(clear_list); // 마킹된 temp_list도 제거됨
이와 같은 방식으로 ds_list_mark_as_list 함수를 활용하여 데이터 구조를 효율적으로 관리하고, JSON 인코딩 및 가비지 수집을 용이하게 할 수 있습니다.