CKTIS / Java
java.util.Map — preslikava ključev v vrednosti
Map<K,V> vsakemu ključu priredi največ eno vrednost. Spoznajte iskanje, posodabljanje in izračunavanje vrednosti ter poglede na mapo, s posebnim poudarkom na obravnavi null in zagotovilih implementacije.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Map<K, V> map = new HashMap<>();java.util.Map<K,V> je vmesnik za preslikavanje ključev v vrednosti; vrednosti se lahko ponavljajo. HashMap ne zagotavlja vrstnega reda, medtem ko TreeMap razvršča ključe. Podpora za null je odvisna od implementacije. Shranjenega ključa ne spreminjajte tako, da bi to vplivalo na njegovo primerjanje.
Map.put(k, v) doda ali zamenja vrednost in vrne prejšnjo; Map.remove(k) odstrani vnos in vrne njegovo staro vrednost. Če vnosa ni, obe metodi prav tako vrneta null. Map.get(k) vrne vrednost ali null; Map.containsKey(k) razlikuje med manjkajočim vnosom in vnosom, ki mu je prirejen null. Map.getOrDefault(k, d) vrne d samo, če vnosa ni, ne pa tudi, če je njegova vrednost null. Map.size() prešteje vnose; Map.containsValue(v) preveri, ali se vrednost pojavlja.
Map.compute(k, f) funkciji posreduje ključ in trenutno vrednost ali null; rezultat null odstrani vnos ali poskrbi, da ostane odsoten. Map.computeIfAbsent(k, f) pokliče funkcijo, če vnosa ni ali je njegova vrednost null; rezultat shrani le, če ni null. Map.merge(k, v, f) zahteva v != null: če vnosa ni ali je njegova vrednost null, shrani v, sicer združi staro vrednost z v. Rezultat null odstrani vnos.
Map.keySet() razkrije množico ključev, Map.values() zbirko vrednosti, Map.entrySet() pa množico parov Map.Entry<K,V>. To so pogledi, povezani z mapo, ne kopije; odstranjevanje prek pogleda odstrani vnos, če je operacija podprta. Map.forEach(action) obišče vsak par.
Operacije, ki spreminjajo mapo, lahko sprožijo UnsupportedOperationException. Funkcije za izračunavanje ne bi smele spreminjati iste mape. Privzete metode Map ne zagotavljajo ne atomarnosti ne sinhronizacije. Primer uporablja TreeMap, da je vrstni red izhoda determinističen.
Primeri
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());
}
}Rezultat
3 0 false true 2 [apple, pear] [2, 3] [apple=2, pear=3] apple:2 pear:3 3 1
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.