CKTIS / Java
java.util.Map — sleutels aan waarden koppelen
Map<K,V> koppelt elke sleutel aan maximaal één waarde. Leer waarden op te zoeken en bij te werken, waarden te berekenen en mapweergaven te gebruiken, met speciale aandacht voor null en garanties van de implementatie.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
Map<K, V> map = new HashMap<>();java.util.Map<K,V> is een interface die sleutels aan waarden koppelt; waarden mogen vaker voorkomen. HashMap garandeert geen volgorde, terwijl TreeMap de sleutels sorteert. Ondersteuning voor null hangt af van de implementatie. Wijzig een opgeslagen sleutel niet op een manier die invloed heeft op de vergelijking ervan.
Map.put(k, v) voegt een waarde toe of vervangt deze en geeft de vorige waarde terug; Map.remove(k) verwijdert een item en geeft de oude waarde terug. Beide geven ook null terug als het item ontbreekt. Map.get(k) geeft de waarde of null terug; Map.containsKey(k) maakt onderscheid tussen een ontbrekend item en een item met de waarde null. Map.getOrDefault(k, d) geeft d alleen terug als het item ontbreekt, niet als de gekoppelde waarde null is. Map.size() telt de items; Map.containsValue(v) controleert of een waarde voorkomt.
Map.compute(k, f) geeft de sleutel en de huidige waarde, of null, door aan de functie; een resultaat van null verwijdert het item of laat het ontbreken. Map.computeIfAbsent(k, f) roept de functie aan als het item ontbreekt of de waarde null is; alleen een niet-null-resultaat wordt opgeslagen. Map.merge(k, v, f) vereist v != null: bij een ontbrekend item of een waarde van null wordt v opgeslagen; anders wordt de oude waarde met v gecombineerd. Een resultaat van null verwijdert het item.
Map.keySet() biedt een verzameling sleutels, Map.values() een collectie waarden en Map.entrySet() een verzameling Map.Entry<K,V>-paren. Dit zijn weergaven die aan de map gekoppeld zijn, geen kopieën; verwijderen via een weergave verwijdert het item als dat wordt ondersteund. Map.forEach(action) doorloopt elk paar.
Bewerkingen die de map wijzigen kunnen UnsupportedOperationException veroorzaken. Functies die waarden berekenen, moeten dezelfde map niet wijzigen. De standaardmethoden van Map garanderen noch atomiciteit noch synchronisatie. Het voorbeeld gebruikt TreeMap voor een deterministische uitvoervolgorde.
Voorbeelden
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());
}
}Resultaat
3 0 false true 2 [apple, pear] [2, 3] [apple=2, pear=3] apple:2 pear:3 3 1
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.