Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Map.merge(): sloučení hodnot pro jeden klíč

Pomocí `Map.merge()` uložíš počáteční hodnotu, sloučíš ji se stávající hodnotou nebo odstraníš záznam, pokud funkce vrátí `null`.

Verze: Java SE 21

Syntaxe

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í tutéž výchozí metodu rozhraní java.util.Map, dostupnou od Javy 8. Závorky v názvu neznamenají variantu bez argumentů: metodu voláš na instanci mapy a předáváš jí klíč, vstupní hodnotu a slučovací funkci (BiFunction).

Pokud klíč v mapě není nebo je k němu přiřazeno null, metoda uloží a vrátí vstupní hodnotu bez volání funkce. Jinak funkce dostane nejprve dosavadní hodnotu a pak vstupní hodnotu, nikoli klíč. Výsledek odlišný od null nahradí dosavadní hodnotu a metoda jej vrátí. Výsledek null odstraní celý záznam a metoda vrátí null.

Vstupní hodnota ani samotná funkce nesmí být null. Pokud mapa podporuje merge, předání null místo vstupní hodnoty či funkce vyvolá NullPointerException. Klíč null je povolen jen tehdy, pokud ho mapa podporuje. U nemodifikovatelné mapy vytvořené pomocí Map.of() vyvolá volání merge vždy UnsupportedOperationException, i když je vstupní hodnota nebo funkce null.

Pokud funkce vyhodí nekontrolovanou výjimku, merge ji předá dál a ponechá stávající záznam beze změny. Funkce by během výpočtu neměla měnit tutéž mapu. Výchozí implementace nezaručuje synchronizaci ani atomicitu; ověř si vlastnosti použité implementace v její dokumentaci.

K počítání použij Integer::sum: první záznam začíná na 1 a každý další výskyt téhož klíče zvýší počitadlo. TOTAL je běžný klíč, který příklad aktualizuje samostatným voláním. Při odstranění jiného záznamu se automaticky nezmění.

Pří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ýsledek

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

`HashMap` umožňuje přiřadit klíči `apples` na začátku hodnotu `null`, zatímco `pears` v mapě nejprve není. Obě počitadla začínají na `1` bez volání `Integer::sum`. Nakonec funkce vracející `null` odstraní `pears`; `containsKey` odstranění potvrdí.

Související lekce

  • Java · Lekce 56 · Základní · Verze: 2
  • Java · Lekce 39 · Středně pokročilá · Verze: 2

Zdroje