Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

`Queue.peek()` — leggere la testa della coda senza rimuoverla

Il metodo `peek()` restituisce l’elemento in testa alla coda senza rimuoverlo. Se la coda è vuota, restituisce `null`.

Versione: Java SE 21

Sintassi

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

Queue.peek() è un metodo di istanza dell’interfaccia java.util.Queue<E>. Non accetta argomenti e restituisce l’elemento in testa, di tipo E, senza modificare la coda. L’ordine dipende dall’implementazione: l’elemento in testa non è necessariamente quello inserito per primo.

Se la coda è vuota, peek() restituisce null. Anche element() lascia invariata la coda, ma lancia NoSuchElementException se è vuota. Il metodo poll() rimuove e restituisce l’elemento in testa, oppure restituisce null se la coda è vuota.

Evita di inserire null come elemento. Se l’implementazione lo consente, un risultato null di peek() non permette di distinguere una coda vuota da una coda con null in testa. L’esempio usa ArrayDeque, che non ammette elementi null.

Esempi

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

Risultato

apple
apple
banana
null

La prima chiamata a `peek()` stampa `apple` senza rimuoverlo, quindi la successiva chiamata a `poll()` stampa ancora `apple`, ma lo rimuove. La successiva chiamata a `peek()` stampa `banana`. La seconda chiamata a `poll()` rimuove `banana` senza stamparlo e l’ultima chiamata a `peek()` stampa `null`.

Lezioni correlate

  • Java · Lezione 61 · Base · Versione: 2

Fonti