Справочник Java

List.getFirst()

Возвращает первый или последний элемент упорядоченной коллекции.

Доступно с: Java 21

Синтаксис

default E getFirst()
default E getLast()

Возвращаемое значение

EПервый (или последний) элемент.

Примеры

Первый и последний элемент без индексов:

void main() {
    List<String> queue = new ArrayList<>(List.of("Anna", "Oleg", "Ivan"));
    IO.println(queue.getFirst());
    IO.println(queue.getLast());
    queue.removeFirst();
    IO.println(queue);
}

Результат:

Anna
Ivan
[Oleg, Ivan]

У пустого списка — исключение:

void main() {
    try {
        new ArrayList<String>().getFirst();
    } catch (NoSuchElementException e) {
        IO.println(e);
    }
}

Результат:

java.util.NoSuchElementException

Примечания

Методы пришли из интерфейса SequencedCollection (Java 21) и есть у List, Deque, LinkedHashSet и TreeSet. Там же объявлены addFirst(), addLast(), removeFirst(), removeLast(). Пустая коллекция бросает NoSuchElementException, поэтому сначала проверяйте isEmpty().

См. также

List.get() — Возвращает элемент списка по индексу.
List.reversed() — Возвращает список в обратном порядке, не копируя его.
List.isEmpty() — Проверяет, пуст ли список.

Вопросы и ответы по теме

Как получить первый и последний элемент списка

В учебнике

Списки: List и ArrayList — Списки в Java: ArrayList, добавление, чтение и удаление элементов, неизменяемые списки List.of и списки чисел.

Спасибо, что читаете!