CKTIS / Java
`Queue.peek()` — consultar la cabeza de una cola sin extraerla
El método `peek()` devuelve el elemento situado en la cabeza de una cola sin extraerlo. Si la cola está vacía, devuelve `null`.
Versión: Java SE 21
Sintaxis
E peek();
// Example call on a Queue<String>:
String head = queue.peek();Queue.peek() es un método de instancia de la interfaz java.util.Queue<E>. No recibe argumentos y devuelve el elemento de la cabeza, de tipo E, sin modificar la cola. El orden lo determina la implementación, por lo que la cabeza no contiene necesariamente el elemento que se insertó primero.
Si la cola está vacía, peek() devuelve null. El método element() tampoco modifica la cola, pero lanza NoSuchElementException si está vacía. El método poll() extrae y devuelve el elemento de la cabeza, o devuelve null si la cola está vacía.
Evita insertar null como elemento. Si la implementación lo permite, un resultado null de peek() no distingue entre una cola vacía y una cola con null en la cabeza. El ejemplo usa ArrayDeque, que no admite elementos null.
Ejemplos
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());
}
}Resultado
apple apple banana null
La primera llamada a `peek()` muestra `apple` sin extraerlo, así que la siguiente llamada a `poll()` también muestra `apple`, pero lo extrae. La siguiente llamada a `peek()` muestra `banana`. La segunda llamada a `poll()` extrae `banana` sin mostrarlo, y la última llamada a `peek()` muestra `null`.
Lecciones relacionadas
- Java · Lección 61 · Básico · Versión: 2