CKTIS / Java
java.util.Map — preslikavanje ključeva u vrijednosti
Map<K,V> pridružuje svakom ključu najviše jednu vrijednost. Upoznajte dohvat i ažuriranje podataka, izračunavanje vrijednosti i poglede na mapu, s posebnim naglaskom na obradu vrijednosti null i jamstva implementacije.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Map<K, V> map = new HashMap<>();java.util.Map<K,V> sučelje je za preslikavanje ključeva u vrijednosti; vrijednosti se mogu ponavljati. HashMap ne jamči redoslijed, dok TreeMap sortira ključeve. Podrška za null ovisi o implementaciji. Nemojte mijenjati pohranjeni ključ na način koji utječe na njegovu usporedbu.
Map.put(k, v) dodaje ili zamjenjuje vrijednost i vraća prethodnu; Map.remove(k) uklanja unos i vraća njegovu staru vrijednost. Ako unos ne postoji, obje metode također vraćaju null. Map.get(k) vraća vrijednost ili null; Map.containsKey(k) razlikuje nepostojeći unos od unosa kojem je pridružen null. Map.getOrDefault(k, d) vraća d samo ako unos ne postoji, a ne ako mu je pridružen null. Map.size() broji unose; Map.containsValue(v) provjerava pojavljuje li se vrijednost.
Map.compute(k, f) funkciji prosljeđuje ključ i trenutačnu vrijednost ili null; rezultat null uklanja unos ili ga ostavlja nepostojećim. Map.computeIfAbsent(k, f) poziva funkciju ako unos ne postoji ili mu je vrijednost null; pohranjuje samo rezultat koji nije null. Map.merge(k, v, f) zahtijeva v != null: ako unos ne postoji ili mu je vrijednost null, pohranjuje v; inače spaja staru vrijednost s v. Rezultat null uklanja unos.
Map.keySet() izlaže skup ključeva, Map.values() kolekciju vrijednosti, a Map.entrySet() skup parova Map.Entry<K,V>. To su pogledi povezani s mapom, a ne kopije; uklanjanje putem pogleda uklanja unos ako je operacija podržana. Map.forEach(action) prolazi kroz svaki par.
Operacije koje mijenjaju mapu mogu izazvati UnsupportedOperationException. Funkcije za izračunavanje ne bi trebale mijenjati istu mapu. Zadane metode sučelja Map ne jamče ni atomarnost ni sinkronizaciju. Primjer upotrebljava TreeMap kako bi redoslijed izlaza bio deterministički.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.