Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes