ds_map_add_list

通过此函数,您可以将 (之前创建的 )DS 列表 分配给给定 DS 映射中的键。

此函数旨在创建 JSON 兼容地图,然后您可以使用 json_encode 对其进行编码,并且只能与该功能结合使用。如果 DS 地图以这种方式添加了列表,则销毁父地图也会销毁所包含的列表并释放其内存,并且在父地图上调用 ds_map_clear 也会销毁并清除所有已标记的列表列表。

 

语法:

ds_map_add_list(id, key, value)

参数类型描述
idDS Map要使用的地图的 ID。
keyString添加列表的密钥。
valueDS List要添加的列表的 ID。

 

返回:

N/A

 

例子:

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);

以上代码将创建一个列表,并使用全局变量的各种值填充该列表。然后,该列表被"嵌套"在DS映射中,然后该映射被编码成JSON字符串,在该映射被销毁之前,从存储器中删除它及其包含的任何列表。