Langage BASICMaps

AddMapElement

Commande de map

Syntaxe

Crée l’entrée d’une clé et en fait l’entrée courante. Une entrée qui existe déjà est remise à la valeur par défaut.

AddMapElement(<map>(), <key> [, <flags>])

Les éléments

<map>La table, écrite avec ses parenthèses vides : stock(). Ce doit être une variable NewMap ou un champ table d’un enregistrement.
<key>La clé. Elle est convertie en texte : 1 et "1" sont la même clé. Majuscules et minuscules comptent.
<flags>Facultatif. Doit valoir 0, la valeur par défaut.

Rend

Toujours 1.

À savoir

  • AddMapElement sur une clé existante n’ajoute pas de seconde entrée : il remet la valeur par défaut (0, "" ou un enregistrement vide). Pour écrire une valeur sans cette remise à zéro, affectez-la : m("key") = v.
  • L’entrée devient courante : m() la lit ou l’écrit aussitôt.
  • Tout <flags> différent de 0 arrête le programme : « Aukimi maps preserve unique keys; AddMapElement flags must be 0 ». Le #PB_Map_NoElementCheck de PureBasic n’a pas d’équivalent.
  • Un mauvais nombre d’arguments, ou un argument qui n’est pas une table, est une erreur de compilation.

Exemple

NewMap stock.i()stock("apple") = 7Console(Str(AddMapElement(stock(), "pear")))   ' 1stock() = 5AddMapElement(stock(), "apple")Console(MapKey(stock()) + " " + Str(stock()))   ' apple 0Console(Str(MapSize(stock())))   ' 2
Dans le manuel : Tableaux, listes et maps

Voir aussi