Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Chiavi estreme di SortedMap: firstKey() e lastKey()

`firstKey()` e `lastKey()` restituiscono le chiavi ai due estremi dell’ordinamento della mappa. Entrambi lanciano `NoSuchElementException` se la mappa è vuota.

Versione: Java SE 21

Sintassi

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

In java.util.SortedMap<K,V>, firstKey() restituisce la prima chiave e lastKey() l’ultima. Entrambi i metodi non accettano argomenti, restituiscono una chiave di tipo K anziché un valore o una coppia chiave-valore e non rimuovono alcuna coppia dalla mappa.

A stabilire quale chiave viene prima è l’ordinamento delle chiavi della mappa: quello naturale se comparator() restituisce null, altrimenti quello definito dal comparatore. L’ordine di inserimento non conta. Per le chiavi 10, 70 e 120, l’ordinamento naturale mette 10 per prima e 120 per ultima. Con Comparator.reverseOrder() accade il contrario: 120 è la prima e 10 l’ultima.

Su una mappa vuota, ciascuna chiamata lancia NoSuchElementException anziché restituire null. Se la mappa non può cambiare tra il controllo e la lettura, puoi prima chiamare isEmpty(). In Java SE 21, SortedMap eredita anche firstEntry() e lastEntry() da SequencedMap: i due metodi restituiscono un Map.Entry<K,V> oppure null se la mappa è vuota.

Esempi

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");
    }
}

Risultato

natural: 10/120
reverse: 120/10
firstKey: NoSuchElementException
lastKey: NoSuchElementException

Le righe attese `natural: 10/120` e `reverse: 120/10` mostrano l’effetto del comparatore. Le ultime due corrispondono alle eccezioni intercettate separatamente sulla mappa vuota.

Lezioni correlate

  • Java · Lezione 20 · Avanzato · Versione: 2

Fonti