База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Крайни ключове в SortedMap: firstKey() и lastKey()

`firstKey()` и `lastKey()` връщат ключовете в двата края на подредбата на картата. При празна карта и двата метода хвърлят `NoSuchElementException`.

Версия: Java SE 21

Синтаксис

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

В java.util.SortedMap<K,V> методът firstKey() връща първия ключ, а lastKey() — последния. И двата метода се извикват без аргументи, връщат ключ от тип K, а не стойност или запис ключ–стойност, и не премахват записи.

Кой ключ е първи се определя от подредбата на ключовете в картата: естествената подредба, ако comparator() връща null, или подредбата, зададена от компаратора. Редът на добавяне няма значение. За ключовете 10, 70 и 120 в естествената подредба първи е 10, а последен е 120. С Comparator.reverseOrder() е обратното: първи е 120, а последен е 10.

При празна карта всяко от двете извиквания хвърля NoSuchElementException, вместо да върне null. Ако картата не може да се промени между проверката и прочитането на ключа, първо можеш да извикаш isEmpty(). В Java SE 21 SortedMap наследява от SequencedMap и методите firstEntry() и lastEntry(): те връщат запис Map.Entry<K,V> или null, ако картата е празна.

Примери

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

Резултат

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

Очакваните редове `natural: 10/120` и `reverse: 120/10` показват ефекта на компаратора. Последните два реда съответстват на двете изключения, прихванати поотделно при празната карта.

Свързани уроци

  • Java · Урок 20 · Напреднало · Версия: 2

Източници