DeleteMapElement()

Syntax

DeleteMapElement(Map() [, Key$])

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

Parameter

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

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

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.

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