CKTIS / Java
Krajní klíče v SortedMap: firstKey() a lastKey()
`firstKey()` a `lastKey()` vracejí klíče na obou koncích uspořádání mapy. Pokud je mapa prázdná, obě metody vyhodí výjimku `NoSuchElementException`.
Verze: Java SE 21
Syntaxe
In java.util.SortedMap<K,V>:
K firstKey();
K lastKey();V java.util.SortedMap<K,V> vrací firstKey() první klíč a lastKey() poslední. Obě metody jsou bez argumentů, vracejí klíč typu K, nikoli hodnotu ani dvojici klíč–hodnota, a žádnou položku neodebírají.
První klíč určuje uspořádání klíčů v mapě: přirozené, pokud comparator() vrací null, jinak podle komparátoru mapy. Na pořadí vkládání nezáleží. Pro klíče 10, 70 a 120 je při přirozeném uspořádání první 10 a poslední 120. S Comparator.reverseOrder() je tomu naopak: první je 120 a poslední 10.
U prázdné mapy každé z těchto volání vyhodí výjimku NoSuchElementException, místo aby vrátilo null. Pokud se mapa mezi kontrolou a čtením nemůže změnit, můžeš nejdřív zavolat isEmpty(). V Java SE 21 dědí SortedMap z SequencedMap také metody firstEntry() a lastEntry(): vracejí položku Map.Entry<K,V>, nebo null, pokud je mapa prázdná.
Příklady
import java.util.Comparator;
import java.util.NoSuchElementException;
import java.util.SortedMap;
import java.util.TreeMap;
public class Main {
public static void main(String[] args) {
SortedMap<Integer, String> natural = new TreeMap<>();
natural.put(70, "middle");
natural.put(120, "high");
natural.put(10, "low");
SortedMap<Integer, String> reverse = new TreeMap<>(Comparator.reverseOrder());
reverse.putAll(natural);
System.out.println("natural: " + natural.firstKey() + "/" + natural.lastKey());
System.out.println("reverse: " + reverse.firstKey() + "/" + reverse.lastKey());
SortedMap<Integer, String> empty = new TreeMap<>();
expectEmptyFailure("firstKey", empty::firstKey);
expectEmptyFailure("lastKey", empty::lastKey);
}
private static void expectEmptyFailure(String method, Runnable call) {
try {
call.run();
} catch (NoSuchElementException expected) {
System.out.println(method + ": NoSuchElementException");
return;
}
throw new AssertionError(method + " did not throw NoSuchElementException");
}
}Výsledek
natural: 10/120 reverse: 120/10 firstKey: NoSuchElementException lastKey: NoSuchElementException
Očekávané řádky `natural: 10/120` a `reverse: 120/10` ukazují vliv komparátoru. Poslední dva řádky odpovídají výjimkám zachyceným samostatně u prázdné mapy.
Související lekce
- Java · Lekce 20 · Pokročilá · Verze: 2