CKTIS / Java
SortedMap — mapa usporiadaná podľa kľúčov
SortedMap usporadúva kľúče podľa ich prirodzeného poradia alebo pomocou komparátora. firstKey() a lastKey() vracajú krajné kľúče v tomto poradí; ak je mapa prázdna, obe metódy vyvolajú výnimku.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
SortedMap<Integer, String> map = new TreeMap<>();
map.put(10, "A");
map.put(30, "C");
Integer first = map.firstKey();
Integer last = map.lastKey();SortedMap<K, V> je rozhranie mapy, ktorej kľúče sú usporiadané, nie hodnoty ani poradie vkladania. Používa prirodzené poradie alebo Comparator. Tomuto poradiu zodpovedá aj iterácia. TreeMap je jedna z implementácií.
SortedMap.firstKey (firstKey()) vracia prvý kľúč, zatiaľ čo SortedMap.lastKey (lastKey()) vracia posledný. Ani jedna metóda neodstraňuje záznamy ani nevracia hodnoty. Pri obrátenom komparátore môže byť prvý kľúč číselne najväčší. Ak je mapa prázdna, obe metódy vyvolajú NoSuchElementException.
Kľúče musia byť navzájom porovnateľné. Výsledok porovnania rovný nule znamená, že ide o ten istý kľúč mapy; poradie by malo byť konzistentné s equals, aby sa zachovala zmluva rozhrania Map.
Príklad používa TreeMap s prirodzeným číselným poradím: hoci sa ako prvé vloží 30, krajné kľúče sú 10 a 30. Rozsah dokumentácie: Java SE 21; produkčné runtime prostredie nebolo potvrdené.
Príklady
import java.util.SortedMap;
import java.util.TreeMap;
public class Main {
public static void main(String[] args) {
SortedMap<Integer, String> map = new TreeMap<>();
map.put(30, "C");
map.put(10, "A");
map.put(20, "B");
System.out.println(map.firstKey());
System.out.println(map.lastKey());
map.forEach((key, value) -> System.out.println(key + "=" + value));
}
}Výsledok
10 30 10=A 20=B 30=C
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.