ds_map_add(id, key, val);
| Argument | La description |
|---|---|
| id | L'identifiant de la carte à ajouter. |
| key | La clé de la valeur à ajouter. |
| val | La valeur à ajouter à la carte. |
Renvoie: Boolean
Cette fonction doit être utilisée pour ajouter des ensembles de paires clé / valeur dans le fichier ds_map spécifié. Vous pouvez vérifier cette fonction pour voir si elle a réussi ou non, car elle peut échouer s'il existe déjà la même clé dans le fichier ds_map ou si vous spécifiez un fichier ds_map inexistant comme l'identifiant de la carte à ajouter. Les clés et les valeurs peuvent être constituées de nombres entiers ou de chaînes, de sorte que tous les éléments suivants sont acceptables:
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");
Vous pouvez également ajouter à une carte en utilisant l'accesseur "?", Comme indiqué ci-dessous:
map[? 5] = 1;
map[? "level"] = 100;
map[? 89] = "hello world";
map[? "fish"] = "good";
NOTE: Contrairement à d'autres structures de données dans GameMaker Studio 2, cette clé ne va pas au début (ni à la fin) de la carte ds_map, mais elle ira juste dans la carte ds_map quelque part.
inventory = ds_map_create();
ds_map_add(inventory, "hp potion", 1);
ds_map_add(inventory, "gold", 100);
Cela créera une nouvelle carte, assignant son identifiant à la variable "inventaire". Il ajoute ensuite deux nouvelles clés à la carte, "hp potion" et "gold", et définit leurs valeurs initiales comme 1 et 100.