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
FreeMapsur 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()))) ' 1Dans le manuel : Tableaux, listes et maps