FreeMap

Commande de map

Syntaxe

Retire toutes les entrées d’une table et la libère. Une table libérée ne sert plus tant qu’elle n’est pas redéclarée avec NewMap.

FreeMap(<map>())

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.

À savoir

  • Après FreeMap, MapSize() rend -1 et MapKey() rend "". Lire ou écrire une entrée, ou tout autre appel de table, arrête le programme avec « BASIC map is not initialized ».
  • Un second FreeMap sur la même table ne fait rien et ne lève pas d’erreur.
  • Pour vider une table et continuer à s’en servir, appelez plutôt ClearMap().

Exemple

NewMap stock.i()stock("apple") = 3FreeMap(stock())Console(Str(MapSize(stock())))   ' -1NewMap stock.i()stock("pear") = 5Console(Str(MapSize(stock())))   ' 1
Dans le manuel : Tableaux, listes et maps