getMapValue()

Zusammenfassung

Speichert den Wert in der angegebenen Map unter dem angegebenen Schlüssel. Map- und Schlüsselnamen sind Namen. Wenn keine Map oder in einer definierten Map kein Schlüssel vorhanden ist, wird NoValue zurückgegeben.

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

Syntax

getMapValue ( map As Name, _
              key As Name ) As Any 

Argument	Typ	Beschreibung
map	Name	Der Name der Map. Muss mithilfe von defineMap() definiert sein.
key	Name	Der Name des abzurufenden Werts. Muss mithilfe von SetMapValue() festgelegt worden sein.

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