CKTIS / Java
Queue.poll() — extraer el elemento de la cabeza de la cola
`Queue.poll()` devuelve y elimina el elemento situado en la cabeza de una cola. Si la cola está vacía, devuelve `null` en vez de lanzar una excepción.
Versión: Java SE 21
Sintaxis
E poll();
// Call on a Queue<E> instance:
E head = queue.poll();Queue.poll() es un método sin argumentos de la interfaz java.util.Queue<E>. Devuelve el elemento de la cabeza, de tipo E, y lo elimina de la cola. Si la cola está vacía, devuelve null sin esperar a que se añada un elemento.
La implementación de la cola determina qué elemento está en la cabeza. En el ejemplo, ArrayDeque añade elementos al final con offer() y los extrae de la cabeza con poll(), por lo que sigue el orden FIFO: el primero en entrar es el primero en salir. No todas las colas siguen ese orden.
peek() devuelve el elemento de la cabeza sin eliminarlo, o null si la cola está vacía. remove() sin argumentos devuelve y elimina ese elemento, pero lanza NoSuchElementException si la cola está vacía.
Evita almacenar null como elemento, aunque la implementación lo permita: el resultado null por sí solo no distingue entre una cola vacía y la extracción de un elemento cuyo valor es null. ArrayDeque 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("A");
queue.offer("B");
System.out.println(queue.peek());
System.out.println(queue.poll());
System.out.println(queue.poll());
System.out.println(queue.poll());
}
}Resultado
A A B null
El primer `A` procede de `peek()`, que no elimina el elemento. Las dos llamadas siguientes a `poll()` extraen primero `A` y luego `B`. La última devuelve `null` porque la cola ya está vacía.
Lecciones relacionadas
- Java · Lección 61 · Básico · Versión: 2