setMapValue()

Zusammenfassung

Speichert den Wert in der angegebenen Map unter dem angegebenen Schlüssel. Map und den Namen Names . Die Tabelle muss bereits mithilfe von defineMap()definiert sein. Wenn das Map nicht definiert wurde, hat setMapValue () keine Wirkung und gibt False . 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 Wert ist nicht in einem Part oder keine list mit einem Part auf jeder Ebene. 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