WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

`Queue.peek()` — das vorderste Element lesen, ohne es zu entfernen

`peek()` liefert das vorderste Element einer Warteschlange, ohne es zu entfernen. Ist die Warteschlange leer, gibt die Methode `null` zurück.

Version: Java SE 21

Syntax

E peek();
// Example call on a Queue<String>:
String head = queue.peek();

Queue.peek() ist eine Instanzmethode der Schnittstelle java.util.Queue<E>. Sie erwartet keine Argumente und gibt das vorderste Element als Wert vom Typ E zurück, ohne die Warteschlange zu verändern. Die Implementierung bestimmt die Reihenfolge: Vorne steht nicht unbedingt das Element, das zuerst eingefügt wurde.

Bei einer leeren Warteschlange gibt peek() null zurück. Auch element() verändert die Warteschlange nicht, löst aber bei einer leeren Warteschlange eine NoSuchElementException aus. poll() entfernt das vorderste Element und gibt es zurück. Ist die Warteschlange leer, gibt poll() null zurück.

Füge null nicht als Element ein. Wenn die Implementierung das erlaubt, lässt sich am Ergebnis null von peek() nicht erkennen, ob die Warteschlange leer ist oder null vorne steht. Das Beispiel verwendet ArrayDeque, das keine null-Elemente zulässt.

Beispiele

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

Ergebnis

apple
apple
banana
null

Das erste `peek()` gibt `apple` aus, ohne es zu entfernen. Das folgende `poll()` gibt deshalb ebenfalls `apple` aus, entfernt es aber. Das nächste `peek()` gibt `banana` aus. Das zweite `poll()` entfernt `banana` ohne Ausgabe; das letzte `peek()` gibt `null` aus.

Zugehörige Lektionen

  • Java · Lektion 61 · Grundlagen · Version: 2

Quellen