DeleteMapElement()

Syntaxe

Resultat = DeleteMapElement(Map() [, Cle$])
Description
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

Si le paramètre optionnel "Cle$" est spécifié, il n'y aura pas d'élément courant après cet appel. Sinon, après cette opération, le nouvel élément courant est l'élément précédant celui venant d'être effacé, mais comme une map n'est pas ordonnée, ce peut être n'importe quel élément. Si cet élément n'existe pas (le premier élément a été effacé), alors il n'y aura plus d'élément courant (il sera avant le premier élément, comme après un ResetMap()).

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

<- CopyMap() - Map Index - FindMapElement() ->