CKTIS / Java
`Queue.peek()` — odczyt początku kolejki bez usuwania
Metoda `peek()` zwraca element znajdujący się na początku kolejki bez jego usuwania. Gdy kolejka jest pusta, zwraca `null`.
Wersja: Java SE 21
Składnia
E peek();
// Example call on a Queue<String>:
String head = queue.peek();Queue.peek() to metoda instancji interfejsu java.util.Queue<E>. Nie przyjmuje argumentów i zwraca element typu E z początku kolejki, nie zmieniając jej zawartości. To implementacja określa kolejność: element na początku nie musi być tym, który dodano najwcześniej.
W pustej kolejce peek() zwraca null. Metoda element() również nie usuwa elementu, ale dla pustej kolejki zgłasza NoSuchElementException. Metoda poll() usuwa i zwraca element z początku kolejki, a gdy kolejka jest pusta, zwraca null.
Nie dodawaj null jako elementu kolejki. Jeśli implementacja na to pozwala, wynik null z peek() nie odróżnia pustej kolejki od kolejki z null na początku. Użyta w przykładzie klasa ArrayDeque nie dopuszcza elementów null.
Przykłady
import java.util.ArrayDeque;
import java.util.Queue;
public class Main {
public static void main(String[] args) {
Queue<String> queue = new ArrayDeque<>();
queue.offer("apple");
queue.offer("banana");
System.out.println(queue.peek());
System.out.println(queue.poll());
System.out.println(queue.peek());
queue.poll();
System.out.println(queue.peek());
}
}Wynik
apple apple banana null
Pierwsze `peek()` wypisuje `apple`, pozostawiając ten element w kolejce, więc następujące po nim `poll()` również wypisuje `apple`, ale go usuwa. Kolejne `peek()` wypisuje `banana`. Drugie `poll()` usuwa `banana` bez wypisywania, a ostatnie `peek()` wypisuje `null`.
Powiązane lekcje
- Java · Lekcja 61 · Podstawowy · Wersja: 2