DeleteMapElement()

Syntax

Ergebnis = DeleteMapElement(Map() [, Key$])

Entfernt das aktuelle Element oder das Element mit dem angegebenen Schlüssel (Key$) aus der angegebenen Map.

Parameter

Map()	Die zu verwendende Map.
Key$ (optional)	Der Schlüssel (Key$) für den zu entfernenden Eintrag. Wird dieser nicht angegeben, dann wird das aktuelle Element der Map gelöscht.

Rückgabewert

Gibt die Speicheradresse des neuen aktuellen Elements in der Map zurück. Falls die Map nach der Löschung kein aktuelles Element hat, ist das Ergebnis gleich 0.

Anmerkungen

Nach diesem Aufruf wird vorherige Element (dasjenige vor dem gelöschten Element) zum neuen aktuellen Element. Dabei handelt es sich um ein beliebiges Element, da eine Map nicht sortiert ist. Wenn dieses Element nicht existiert (mit anderen Worten, Sie haben das erste Element in der Map gelöscht), dann gibt es kein aktuelles Element mehr; Sie befinden sich vor dem ersten Element, wie nach einem ResetMap(). Wenn sich nur ein Element in der Map befunden hat, wenn Sie dieses gelöscht haben, dann bleiben Sie ohne ein aktuelles Element zurück!

Wenn der optionale Parameter 'Key$' (Schlüssel) angegeben wird, dann gibt es nach diesem Aufruf kein aktuelles Element mehr. Verwenden Sie diesen Parameter daher nicht, wenn der Befehl innerhalb einer ForEach : Next Schleife verwendet wird!

Beispiel

  NewMap Country.s()

  Country("US") = "United States"
  Country("FR") = "France"
  Country("GE") = "Germany"

  ; Löschen eines Landes
  DeleteMapElement(Country(), "FR")
  
  ForEach Country()
    Debug Country()
  Next

Siehe auch

AddMapElement(), ClearMap(), MapSize()

Unterstützte OS

Alle