Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Map.merge(): spajanje vrijednosti za jedan ključ

Pomoću metode `Map.merge()` spremi početnu vrijednost, spoji je s postojećom vrijednošću ili ukloni unos ako funkcija vrati `null`.

Verzija: Java SE 21

Sintaksa

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

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

Map.merge i Map.merge() označavaju istu zadanu metodu sučelja java.util.Map, dostupnu od Jave 8. Zagrade u nazivu ne označavaju inačicu bez argumenata: metodu pozivaš na instanci mape i predaješ joj ključ, ulaznu vrijednost i funkciju za spajanje (BiFunction).

Ako ključ ne postoji ili mu je pridružena vrijednost null, metoda sprema i vraća ulaznu vrijednost bez pozivanja funkcije. Inače funkcija prima najprije prethodnu pa ulaznu vrijednost, a ne ključ. Rezultat različit od null zamjenjuje prethodnu vrijednost i metoda ga vraća. Ako je rezultat null, metoda uklanja cijeli unos i vraća null.

Ni ulazna vrijednost ni sama funkcija ne smiju biti null. Ako mapa podržava merge, prosljeđivanje null umjesto ulazne vrijednosti ili funkcije uzrokuje NullPointerException. Ključ null dopušten je samo ako ga mapa podržava. Na nepromjenjivoj mapi stvorenoj pomoću Map.of() poziv metode merge uvijek baca UnsupportedOperationException, čak i ako je ulazna vrijednost ili funkcija null.

Ako funkcija baci neprovjeravanu iznimku, merge je prosljeđuje i ostavlja postojeći unos nepromijenjenim. Funkcija ne bi trebala mijenjati istu mapu tijekom izračuna. Zadana implementacija ne jamči ni sinkronizaciju ni atomarnost; provjeri dokumentaciju implementacije koju upotrebljavaš.

Za brojanje upotrijebi Integer::sum: prvi unos počinje od 1, a svako sljedeće pojavljivanje istog ključa povećava brojač. TOTAL je običan ključ koji primjer ažurira zasebnim pozivom. Ne mijenja se automatski kad se ukloni drugi unos.

Primjeri

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"));
    }
}

Rezultat

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

`HashMap` dopušta da ključ `apples` u početku ima vrijednost `null`, dok ključa `pears` isprva nema. Oba brojača počinju od `1` bez poziva `Integer::sum`. Na kraju funkcija koja vraća `null` uklanja `pears`; `containsKey` potvrđuje uklanjanje.

Povezane lekcije

  • Java · Lekcija 56 · Osnovno · Verzija: 2
  • Java · Lekcija 39 · Srednje · Verzija: 2

Izvori