Справочник Java

Queue.peek()

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

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

Синтаксис

E peek()

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

EПервый элемент без удаления или `null`, если очередь пуста.

Примеры

Посмотреть, не забирая:

void main() {
    Queue<String> q = new ArrayDeque<>(List.of("first", "second"));
    IO.println(q.peek());
    IO.println(q.size());
    q.clear();
    IO.println(q.peek());
}

Результат:

first
2
null

Примечания

У стека на ArrayDeque peek() показывает вершину — последний положенный через push() элемент. Версия element() на пустой очереди бросает NoSuchElementException.

См. также

Queue.poll() — Забирает и удаляет первый элемент очереди.
Queue.offer() — Добавляет элемент в конец очереди.
Deque.push() — Кладёт элемент на вершину стека (в начало двусторонней очереди).

В учебнике

Очереди и деки — Очереди в Java: Queue и ArrayDeque, стек на основе Deque, методы offer, poll и peek, очередь с приоритетом PriorityQueue.

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