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