Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Krajnji ključevi u SortedMap: firstKey() i lastKey()

`firstKey()` i `lastKey()` vraćaju ključeve na krajevima poretka mape. Ako je mapa prazna, obje metode bacaju iznimku `NoSuchElementException`.

Verzija: Java SE 21

Sintaksa

In java.util.SortedMap<K,V>:
K firstKey();
K lastKey();

U java.util.SortedMap<K,V> metoda firstKey() vraća prvi ključ, a lastKey() posljednji. Obje se metode pozivaju bez argumenata, vraćaju ključ tipa K, a ne vrijednost ni par ključ–vrijednost, i ne uklanjaju unose.

Prvi ključ određuje poredak ključeva u mapi: prirodni ako comparator() vrati null, a inače poredak koji određuje komparator. Redoslijed umetanja nije važan. Za ključeve 10, 70 i 120 u prirodnom je poretku prvi 10, a posljednji 120. Uz Comparator.reverseOrder() vrijedi obrnuto: prvi je 120, a posljednji 10.

Na praznoj mapi svaki od tih poziva baca iznimku NoSuchElementException umjesto da vrati null. Ako se mapa između provjere i čitanja ne može promijeniti, možeš prvo pozvati isEmpty(). U Java SE 21 SortedMap iz sučelja SequencedMap nasljeđuje i metode firstEntry() i lastEntry(): vraćaju unos Map.Entry<K,V> ili null ako je mapa prazna.

Primjeri

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

Očekivani retci `natural: 10/120` i `reverse: 120/10` pokazuju učinak komparatora. Posljednja dva retka odgovaraju iznimkama koje se na praznoj mapi hvataju zasebno.

Povezane lekcije

  • Java · Lekcija 20 · Napredno · Verzija: 2

Izvori