ds_map_keys_to_array 함수 설명

이 문서에서는 ds_map_keys_to_array 함수에 대해 설명합니다. 이 함수는 DS 맵에 포함된 모든 키를 가져오는 데 사용됩니다. ds_map_create()로 반환된 DS 맵 ID를 제공하면, 함수는 각 항목이 DS 맵의 키인 배열을 반환합니다.

함수 사용법

이 함수는 선택적인 두 번째 인자를 가질 수 있습니다. 이 인자에는 사용자가 생성한 배열을 제공할 수 있으며, 이 경우 DS 맵 키 데이터가 기존 배열 데이터에 추가됩니다. 주의할 점은, 함수가 직접 제공된 배열을 수정하지만, 제공된 배열이 없을 경우 새로운 배열에 대한 참조를 반환한다는 것입니다.

문법

ds_map_keys_to_array(id, [array])

인자 설명

반환값

• 배열: DS 맵의 키가 포함된 배열을 반환합니다.

예제

map_keys = ds_map_keys_to_array(inventory);

위 코드는 DS 맵의 키를 가져와서 향후 사용을 위해 배열에 저장합니다.

활용 예제

1. DS 맵의 모든 키 출력하기

var keys = ds_map_keys_to_array(my_map);
for (var i = 0; i < array_length(keys); i++) {
    show_message(keys[i]);
}

1. 기존 배열에 DS 맵 키 추가하기

var existing_array = [];
ds_map_keys_to_array(my_map, existing_array);

1. DS 맵 키를 정렬하여 사용하기

var keys = ds_map_keys_to_array(my_map);
array_sort(keys, true); // 오름차순 정렬

1. DS 맵 키를 기반으로 다른 데이터 처리하기

var keys = ds_map_keys_to_array(my_map);
for (var i = 0; i < array_length(keys); i++) {
    var value = ds_map_find_value(my_map, keys[i]);
    // value를 사용하여 추가 작업 수행
}

1. DS 맵 키의 개수 확인하기

var keys = ds_map_keys_to_array(my_map);
var key_count = array_length(keys);
show_message("키의 개수: " + string(key_count));

이와 같이 ds_map_keys_to_array 함수를 활용하여 DS 맵의 키를 효과적으로 관리하고 사용할 수 있습니다.