CKTIS / Java
SortedMap — mapa seřazená podle klíčů
SortedMap řadí klíče podle jejich přirozeného pořadí nebo pomocí komparátoru. firstKey() a lastKey() vracejí krajní klíče v tomto pořadí; pokud je mapa prázdná, obě metody vyvolají výjimku.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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 rozhraní mapy, jejíž klíče jsou uspořádány, nikoli hodnoty nebo pořadí vkládání. Používá přirozené pořadí nebo Comparator. Tomuto pořadí odpovídá i iterace. TreeMap je jedna z implementací.
SortedMap.firstKey (firstKey()) vrací první klíč, zatímco SortedMap.lastKey (lastKey()) vrací poslední. Ani jedna metoda neodstraňuje záznamy ani nevrací hodnoty. Při obráceném komparátoru může být první klíč číselně největší. Pokud je mapa prázdná, obě metody vyvolají NoSuchElementException.
Klíče musí být vzájemně porovnatelné. Výsledek porovnání rovný nule znamená, že jde o tentýž klíč mapy; pořadí by mělo být konzistentní s equals, aby byla zachována smlouva rozhraní Map.
Příklad používá TreeMap s přirozeným číselným pořadím: přestože se jako první vloží 30, krajní klíče jsou 10 a 30. Rozsah dokumentace: Java SE 21; produkční běhové prostředí nebylo ověřeno.
Pří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ýsledek
10 30 10=A 20=B 30=C
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.