## 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"。