setMapValue()

Zusammenfassung

Speichert den Wert in der angegebenen Map unter dem angegebenen Schlüssel. Map- und Schlüsselnamen sind Namen. Die Tabelle muss bereits mithilfe von defineMap()definiert sein. Wenn die Map nicht definiert wurde, hat setMapValue() keine Wirkung und gibt False zurück. Wenn die Map definiert ist, wird dieser Wert unter dem angegebenen Schlüssel gespeichert. Wenn es bereits einen Wert für den Schlüssel gab, wird der alte Wert verworfen.

Der gespeicherte Wert ist möglicherweise kein Bauteil oder keine Liste mit irgendeinem Bauteil. Zu diesem Zeitpunkt ist keine Prüfung möglich. Nichtbeachtung dieser Einschränkung kann zum Absturz führen.

Syntax

setMapValue ( map As Name, _
              key As Name, _
              value As Any ) As Boolean 

Argument	Typ	Beschreibung
map	Name	Der Name der Map. Muss mithilfe von defineMap() definiert sein.
key	Name	Der Schlüssel, der dem Wert zugeordnet werden soll
value	Any	Der zu speichernde Wert

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