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