DeleteMapElement()

Syntaxe

Resultat = DeleteMapElement(Map() [, Cle$])

Efface un élément.

Arguments

Map()	La map à utiliser.
Cle$	La clé de l'élément. Si ce paramètre n'est pas spécifié alors c'est l'élément courant qui sera supprimé.

Valeur de retour

La valeur renvoyée est un pointeur vers le nouvel élément.
Si la liste ne comporte aucun élément courant après la suppression, le résultat est zéro.

Remarques

Après cet appel, le nouvel élément courant est l'élément précédent (celui qui précéde l'élément supprimé), qui est un élément arbitraire, car une map n'est pas triée. Si cet élément n'existe pas (en d'autres termes, vous avez supprimé le premier élément de la map) alors il n'y a plus d'élément en cours, comme après un ResetMap(). S'il n'y avait qu'un seul élément dans la carte lorsque vous l'avez supprimé, il ne vous reste plus aucun élément en cours !

Si le paramètre optionnel "Cle$" est spécifié, il n'y aura pas d'élément courant après cet appel. N'utilisez donc pas ce paramètre si la commande est utilisée dans une boucle ForEach : Next !

Exemple

  NewMap Pays.s()

  Pays("US") = "United States"
  Pays("FR") = "France"
  Pays("DE") = "Allemagne"

  ; Supprime un pays
  DeleteMapElement(Pays(), "FR")
  
  ForEach Pays()
    Debug Pays()
  Next

Voir aussi

AddMapElement(), ClearMap(), MapSize()

OS Supportés

Tous