CKTIS / Java
Krajné kľúče v SortedMap: firstKey() a lastKey()
`firstKey()` a `lastKey()` vracajú kľúče na oboch koncoch usporiadania mapy. Ak je mapa prázdna, obe metódy vyvolajú výnimku `NoSuchElementException`.
Verzia: Java SE 21
Syntax
In java.util.SortedMap<K,V>:
K firstKey();
K lastKey();V java.util.SortedMap<K,V> vracia firstKey() prvý kľúč a lastKey() posledný. Obe metódy sa volajú bez argumentov, vracajú kľúč typu K, nie hodnotu ani dvojicu kľúč–hodnota, a neodstraňujú žiadnu položku.
Prvý kľúč určuje poradie kľúčov v mape: prirodzené, ak comparator() vráti null, inak podľa komparátora mapy. Na poradí vkladania nezáleží. Pre kľúče 10, 70 a 120 je v prirodzenom poradí prvý 10 a posledný 120. S Comparator.reverseOrder() je to naopak: prvý je 120 a posledný 10.
Pri prázdnej mape každé z týchto volaní vyvolá výnimku NoSuchElementException namiesto vrátenia null. Ak sa mapa medzi kontrolou a čítaním nemôže zmeniť, môžeš najprv zavolať isEmpty(). V Java SE 21 dedí SortedMap z SequencedMap aj metódy firstEntry() a lastEntry(): vracajú položku Map.Entry<K,V> alebo null, ak je mapa prázdna.
Prí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ýsledok
natural: 10/120 reverse: 120/10 firstKey: NoSuchElementException lastKey: NoSuchElementException
Očakávané riadky `natural: 10/120` a `reverse: 120/10` ukazujú vplyv komparátora. Posledné dva riadky zodpovedajú výnimkám zachyteným samostatne pri prázdnej mape.
Súvisiace lekcie
- Java · Lekcia 20 · Pokročilá · Verzia: 2