CKTIS / Java
Skrajna ključa v SortedMap: firstKey() in lastKey()
`firstKey()` in `lastKey()` vrneta ključa na obeh koncih vrstnega reda v preslikavi. Če je preslikava prazna, obe metodi sprožita izjemo `NoSuchElementException`.
Različica: Java SE 21
Sintaksa
In java.util.SortedMap<K,V>:
K firstKey();
K lastKey();V java.util.SortedMap<K,V> vrne firstKey() prvi ključ, lastKey() pa zadnjega. Nobena od metod ne sprejme argumentov. Obe vrneta ključ tipa K, ne vrednosti ali para ključ–vrednost, in ne odstranita nobenega vnosa.
Prvi ključ določa vrstni red ključev v preslikavi: naravni vrstni red, če comparator() vrne null, sicer vrstni red, ki ga določa primerjalnik. Vrstni red vstavljanja ni pomemben. Pri ključih 10, 70 in 120 je v naravnem vrstnem redu prvi 10 in zadnji 120. Z Comparator.reverseOrder() je ravno obratno: prvi je 120, zadnji pa 10.
Pri prazni preslikavi vsak od teh klicev sproži izjemo NoSuchElementException, namesto da bi vrnil null. Če se preslikava med preverjanjem in branjem ne more spremeniti, lahko najprej pokličeš isEmpty(). V Java SE 21 SortedMap iz SequencedMap podeduje tudi metodi firstEntry() in lastEntry(): vrneta vnos Map.Entry<K,V> ali null, če je preslikava prazna.
Primeri
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");
}
}Rezultat
natural: 10/120 reverse: 120/10 firstKey: NoSuchElementException lastKey: NoSuchElementException
Pričakovani vrstici `natural: 10/120` in `reverse: 120/10` pokažeta učinek primerjalnika. Zadnji dve vrstici ustrezata izjemama, ki sta pri prazni preslikavi prestreženi ločeno.
Povezane lekcije
- Java · Lekcija 20 · Napredna · Različica: 2