getMapValue()

Zusammenfassung

Speichert den Wert in der angegebenen Map unter dem angegebenen Schlüssel. Map und den Namen Names . Wenn kein Map oder in einer definierten Map kein Schlüssel, es gibt NoValue .

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	name der Wert. 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