DeleteMapElement()

Syntax

DeleteMapElement(Map() [, Key$])

Entfernt das aktuelle Element aus der angegebenen 'Map()'. 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 wird das diesem Schlüssel zugewiesene Element von der Map gelöscht (wenn es existiert). Es gibt 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

Unterstützte OS

Alle