Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

java.util.Map — associare chiavi e valori

Map<K,V> associa ogni chiave al massimo a un valore. Scopri come cercare e aggiornare i dati, calcolare valori e usare le viste della mappa, prestando particolare attenzione alla gestione di null e alle garanzie dell’implementazione.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

Map<K, V> map = new HashMap<>();

java.util.Map<K,V> è un’interfaccia che associa chiavi a valori; i valori possono ripetersi. HashMap non garantisce alcun ordine, mentre TreeMap ordina le chiavi. Il supporto per null dipende dall’implementazione. Non modificare una chiave memorizzata in modo da influenzarne il confronto.

Map.put(k, v) aggiunge o sostituisce un valore e restituisce quello precedente; Map.remove(k) elimina una voce e restituisce il suo vecchio valore. Entrambi restituiscono anche null se la voce è assente. Map.get(k) restituisce il valore oppure null; Map.containsKey(k) distingue l’assenza da una voce associata a null. Map.getOrDefault(k, d) restituisce d solo se la voce è assente, non se il valore associato è null. Map.size() conta le voci; Map.containsValue(v) verifica se un valore è presente.

Map.compute(k, f) passa alla funzione la chiave e il valore corrente, oppure null; un risultato null elimina la voce o la lascia assente. Map.computeIfAbsent(k, f) chiama la funzione se la voce è assente o il suo valore è null; memorizza solo un risultato non nullo. Map.merge(k, v, f) richiede v != null: se la voce è assente o il suo valore è null, memorizza v; altrimenti combina il vecchio valore con v. Un risultato null elimina la voce.

Map.keySet() espone un insieme di chiavi, Map.values() una raccolta di valori e Map.entrySet() un insieme di coppie Map.Entry<K,V>. Sono viste collegate alla mappa, non copie; se supportata, la rimozione tramite una vista elimina la voce. Map.forEach(action) visita ogni coppia.

Le operazioni che modificano la mappa possono generare UnsupportedOperationException. Le funzioni di calcolo non dovrebbero modificare la stessa mappa. I metodi predefiniti di Map non garantiscono né atomicità né sincronizzazione. L’esempio usa TreeMap per ottenere un ordine di output deterministico.

Esempi

import java.util.Map;
import java.util.TreeMap;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> counts = new TreeMap<>();
        counts.put("pear", 1);
        counts.merge("pear", 2, Integer::sum);
        counts.computeIfAbsent("apple", key -> 1);
        counts.compute("apple", (key, value) -> value + 1);
        System.out.println(counts.get("pear"));
        System.out.println(counts.getOrDefault("plum", 0));
        System.out.println(counts.containsKey("plum"));
        System.out.println(counts.containsValue(2));
        System.out.println(counts.size());
        System.out.println(counts.keySet());
        System.out.println(counts.values());
        System.out.println(counts.entrySet());
        counts.forEach((key, value) -> System.out.println(key + ":" + value));
        System.out.println(counts.remove("pear"));
        System.out.println(counts.size());
    }
}

Risultato

3
0
false
true
2
[apple, pear]
[2, 3]
[apple=2, pear=3]
apple:2
pear:3
3
1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti