Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Map.merge(): zlúčenie hodnôt pre jeden kľúč

Pomocou `Map.merge()` uložíš počiatočnú hodnotu, zlúčiš ju s existujúcou hodnotou alebo odstrániš záznam, ak funkcia vráti `null`.

Verzia: Java SE 21

Syntax

default V merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)

map.merge(key, value, (oldValue, incomingValue) -> combinedValue)

Map.merge a Map.merge() označujú tú istú predvolenú metódu rozhrania java.util.Map, dostupnú od Javy 8. Zátvorky v názve neznamenajú variant bez argumentov: metódu voláš na inštancii mapy a odovzdáš jej kľúč, vstupnú hodnotu a zlučovaciu funkciu (BiFunction).

Ak kľúč v mape nie je alebo je k nemu priradené null, metóda uloží a vráti vstupnú hodnotu bez volania funkcie. Inak funkcia dostane najprv doterajšiu a potom vstupnú hodnotu, nie kľúč. Výsledok odlišný od null nahradí doterajšiu hodnotu a metóda ho vráti. Výsledok null odstráni celý záznam a metóda vráti null.

Vstupná hodnota ani samotná funkcia nesmú byť null. Ak mapa podporuje merge, odovzdanie null namiesto vstupnej hodnoty alebo funkcie vyvolá NullPointerException. Kľúč null je povolený len vtedy, ak ho mapa podporuje. Pri nemodifikovateľnej mape vytvorenej pomocou Map.of() volanie merge vždy vyvolá UnsupportedOperationException, aj keď je vstupná hodnota alebo funkcia null.

Ak funkcia vyvolá nekontrolovanú výnimku, merge ju posunie ďalej a ponechá existujúci záznam bez zmeny. Funkcia by počas výpočtu nemala meniť tú istú mapu. Predvolená implementácia nezaručuje synchronizáciu ani atomicitu; over si vlastnosti použitej implementácie v jej dokumentácii.

Na počítanie použi Integer::sum: prvý záznam začína na 1 a každý ďalší výskyt toho istého kľúča zvýši počítadlo. TOTAL je obyčajný kľúč, ktorý príklad aktualizuje samostatným volaním. Pri odstránení iného záznamu sa automaticky nezmení.

Príklady

import java.util.HashMap;
import java.util.Map;

public class MergeDemo {
    public static void main(String[] args) {
        Map<String, Integer> counts = new HashMap<>();
        counts.put("apples", null);

        for (String item : new String[] {"apples", "pears", "apples"}) {
            counts.merge(item, 1, Integer::sum);
            counts.merge("TOTAL", 1, Integer::sum);
        }

        System.out.println("apples=" + counts.get("apples"));
        System.out.println("pears=" + counts.get("pears"));
        System.out.println("TOTAL=" + counts.get("TOTAL"));

        Integer result = counts.merge("pears", 1, (oldValue, incomingValue) -> null);
        System.out.println("merge result=" + result);
        System.out.println("contains pears=" + counts.containsKey("pears"));
    }
}

Výsledok

apples=2
pears=1
TOTAL=3
merge result=null
contains pears=false

`HashMap` umožňuje spočiatku priradiť kľúču `apples` hodnotu `null`, zatiaľ čo `pears` na začiatku chýba. Obe počítadlá začínajú na `1` bez volania `Integer::sum`. Nakoniec funkcia vracajúca `null` odstráni `pears`; `containsKey` potvrdí odstránenie.

Súvisiace lekcie

  • Java · Lekcia 56 · Základná · Verzia: 2
  • Java · Lekcia 39 · Stredne pokročilá · Verzia: 2

Zdroje