## ds_map_add_list——添加列表到映射表 *把一個現有的列表添加到映射表中* #### **語法：** ```javascript ds_map_add_list(id, key, value) ``` 參數 | 描述 |---|---| id | 需要處理的映射表的索引ID key|需要添加的鍵名 value|需要添加的列表的索引ID #### **返回：** N/A #### **描述：** 使用這個方法你可以把一個現有的列表作為一個值賦給映射表中的某個鍵，這個方法是為了配合JSON字符串編碼而使用的（你可以用"json_encode"方法來編碼），一旦某個列表或映射表被添加進映射表中，銷毀這個映射表時也會將其中的子列表和映射表一并銷毀。 #### **示例：** ```javascript var j_list = ds_list_create(); ds_list_add(j_list, health); ds_list_add(j_list, lives); ds_list_add(j_list, score); var j_map = ds_map_create(); ds_map_add_list(j_map, "list", j_list); var j = json_encode(j_map); ds_map_destroy(j_map); ``` 以上代碼首先創建了一個列表"j_list"然后在其中添加了一些值——"health"、"lives"、"score"等，然后新建了一個"j_map"的映射表，并將列表"j_list"嵌套進這個映射表中作為"list"對應的值，最后把這個映射表編譯為json字符串再把映射表從內存中清除了。