Diese Funktion erhöht den Wert unter Schlüssel a in Map c um b. Jeder Aufruf akkumuliert das Ergebnis. Der bisherige Wert bleibt erhalten, b wird addiert. HINWEIS Ist der initiale Wert in der Map nicht numerisch, wandelt die Funktion ihn zu 0 um. Existiert der Schlüssel a noch nicht, initialisiert die Funktion ihn ebenfalls mit 0.
Die Funktion gibt den Wert von b als BigDecimal zurück. Das gilt auch, wenn die Funktion b nicht addiert hat. Siehe dazu Parameter d.
Typischer Anwendungsfall: Zähler oder Summen über mehrere Iterationen aufbauen. Sammeln Sie z. B. Gesamtmengen oder Positionssummen aus wiederholten Aufrufen.
Parameter
Parameter | Beschreibung |
|---|---|
a | Schlüssel des Wertes. |
b | Zu addierender Wert. |
c | (optional) Name der Map. Default: default. |
d | (optional) Bei true ignoriert die Funktion b, wenn dessen Empty Flag gesetzt ist. Default: false. |
Hinweis
Das Empty Flag ist ein internes Merkmal eines Wertes in Lobster. Es kennzeichnet einen Wert als „leer". Das gilt auch, wenn der Wert formal einen Inhalt hat. Ein Beispiel ist ein leerer String. Parameter d steuert, ob solche Werte bei der Addition berücksichtigt werden.
Beispiel
Betrachten Sie die Beispieleinträge als aufeinanderfolgende Aufrufe. Der Wert unter Schlüssel mykey in Map mymap ist initial 0.
Parameter a | Parameter b | Parameter b empty? | Parameter c | Parameter d | Ergebnis | Wert in Map |
|---|---|---|---|---|---|---|
mykey | 123 | Nein | mymap | 123 | 123 | |
mykey | 123 | Nein | mymap | 123 | 246 | |
mykey | 123 | Ja | mymap | 123 | 369 | |
mykey | 123 | Ja | mymap | false | 123 | 492 |
mykey | 123 | Ja | mymap | true | 123 | 492 |
HINWEIS Bei d = true und gesetztem Empty Flag addiert die Funktion b nicht. Der Map-Wert bleibt unverändert (492). Die Funktion gibt aber trotzdem b als BigDecimal zurück (123).