deleteMapValue()

Zusammenfassung

Löscht den durch key angegebenen Eintrag in tableID. Gibt False zurück, wenn für tableID keine Map vorliegt oder key nicht gefunden wird. Gibt True zurück, wenn der Eintrag gefunden und entfernt wurde.

Eine Map-Datenstruktur wird manchmal auch als Hash-Tabelle oder Suchtabelle bezeichnet und wird mit defineMap() erstellt.

Syntax

deleteMapValue ( tableID As Name, _
                 key As Name ) As Boolean 

Argument	Typ	Beschreibung
tableID	Name	Der Name der Map. Muss zuvor mit defineMap() erstellt worden sein.
key	Name	Der Schlüssel, der den zu löschenden Eintrag angibt.

Beispiel 1

In diesem Beispiel wird Folgendes durchgeführt: eine Map wird definiert, eine Reihe von Werten wird festgelegt, die Map wird erneut definiert, ohne sie zurückzusetzen, Map-Schlüssel und einige Werte werden abgerufen, und schließlich wird ein Map-Wert gelöscht.

Intent >defineMap(:myMap)
--> True
Intent >setMapValue(:myMap, :myStringValue, "A String")
--> True
Intent >setMapValue(:myMap, :myIntegerValue, 123)
--> True
Intent >defineMap(:myMap, reset? := False)
--> True
Intent >getMapKeys(:myMap)
--> {:myStringValue, :myIntegerValue}
Intent >getMapValue(:myMap, :myStringValue)
--> "A String"
Intent >getMapValue(:noMap, :noValue)
--> NoValue
Intent >deleteMapValue(:myMap, :myIntegerValue)
--> True
Intent >getMapValue(:myMap, :myIntegerValue)
--> NoValue