映射表（DS Maps）是一種數據結構，可用于存儲成對的鍵、值等數據內容 映射表這種數據結構非常有用，因為它可以同時存儲成對的鍵值內容。比如說，在一個游戲中我們的角色通常會有很多道具（鍵），而每一種道具又會有不同的數量（值），比如一款RPG中，你可以同時擁有10個血瓶，5個藍瓶和100金幣。映射表就是用來存儲這種成對的鍵值內容的，你可以任意添加映射關系，并可以很輕松的通過指定的鍵來查詢對應的值的數據。不過，在正式使用這功能之前，你也需要了解幾個基礎知識！映射表不會以任何方式進行排序，這意味著為了找到某個鍵的值可能需要把整個映射表遍歷一遍（可能會慢），而且映射表中不能同時保存兩個相同的鍵，一個鍵也只能對應一個值。 注意：當前版本中的“ds_map”函數跟以往版本中有區別，因此直接導入老版本的項目可能無法正常工作 注意：跟所有動態資源相同，數據結構會占用設備內存，因此在不再使用時應當將其銷毀以釋放內存，否則可能會造成內存泄漏，從而影響游戲運行速度和效率，最后導致游戲報錯奔潰。 以下是映射表的各個函數方法： * [ds_map_exists](ds_map_exists.md) * [ds_map_create](ds_map_create.md) * [ds_map_add](ds_map_add.md) * [ds_map_clear](ds_map_clear.md) * [ds_map_copy](ds_map_copy.md) * [ds_map_replace](ds_map_replace.md) * [ds_map_delete](ds_map_delete.md) * [ds_map_empty](ds_map_empty.md) * [ds_map_size](ds_map_size.md) * [ds_map_find_first](ds_map_find_first.md) * [ds_map_find_last](ds_map_find_last.md) * [ds_map_find_next](ds_map_find_next.md) * [ds_map_find_previous](ds_map_find_previous.md) * [ds_map_find_value](ds_map_find_value.md) * [ds_map_read](ds_map_read.md) * [ds_map_write](ds_map_write.md) * [ds_map_destroy](ds_map_destroy.md) - - - - - 另外還有四種特殊的方法可以用于保存和讀取映射表，這些方法會對映射表進行加密存儲，因此這些方法可用來保存內購信息、密碼以及較為敏感的游戲信息等 * [ds_map_secure_save](ds_map_secure_save.md) * [ds_map_secure_save_buffer](ds_map_secure_save_buffer.md) * [ds_map_secure_load](ds_map_secure_load.md) * [ds_map_secure_load_buffer](ds_map_secure_load_buffer.md) 除了以上這些方法，你還可以使用通配符（或稱訪問器）來添加或修改映射表中的內容，語法如下： ```javascript map_index[? key] ``` - - - - - ## JSON和映射表 映射表有一個重要的用途就是使用json，因此還有相對應的特殊函數： [ds_map_add_list](ds_map_add_list.md) [ds_map_add_map](ds_map_add_map.md) [ds_map_replace_list](ds_map_replace_list.md) [ds_map_replace_map](ds_map_replace_map.md) 另外也有兩個與ds_lists聯動的方法： [ds_list_mark_as_list](ds_list_mark_as_list.md) [ds_list_mark_as_map](ds_list_mark_as_map.md) 注意：盡管這些函數允許你在映射表中嵌套列表和另一個映射表，但這些方法僅適用于JSON內容，如果你嘗試將這些數據直接保存到磁盤上則無法正確讀取。 *注意：如果你想確認數據結構是否存在，你可以使用"ds_exists()"方法來判斷。*