## ds_map_add——添加键值对 *将指定的键值对添加到映射表中* #### **语法:** ```javascript ds_map_add(id, key, val); ``` 参数 | 描述 |---|---| id | 需要处理的映射表的索引ID key|需要添加的键名 val | 添加键对应的值 #### **返回:** Boolean #### **描述:** 这个函数会将一对特定的键值对添加到指定的映射表中,如果该映射表中已经有相同的键名,或指定了一个不存在的映射表,就会导致添加失败,无论是键名或是值的内容都可以由整数或字符串构成,因此以下操作都是可行的: ```javascritpt ds_map_add(map, 5, 1); ds_map_add(map, "level", 100); ds_map_add(map, 89, "hello world"); ds_map_add(map, "fish", "good"); ``` 你也可以使用通配符"?"来进行操作: ```javascript map[? 5] = 1; map[? "level"] = 100; map[? 89] = "hello world"; map[? "fish"] = "good"; ``` 注意:与GameMaker Studio 2中其他类型的数据结构不同,这个新添加的键值对不会自动加到整个映射表的开头或末尾,而是可能在任意位置插入。 #### **示例:** ```javascript inventory = ds_map_create(); ds_map_add(inventory, "hp potion", 1); ds_map_add(inventory, "gold", 100); ``` 以上代码首先添加了一个名为"inventory"的映射表,然后在其中添加了两个键值对,分别是"hp potion"对应的值为"1",另一对则是"gold"值为"100"。