Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Queue.poll() — retirar e devolver o elemento à cabeça da fila

`Queue.poll()` retira e devolve o elemento à cabeça de uma fila. Se a fila estiver vazia, devolve `null` em vez de lançar uma exceção.

Versão: Java SE 21

Sintaxe

E poll();
// Call on a Queue<E> instance:
E head = queue.poll();

Queue.poll() é um método sem argumentos da interface java.util.Queue<E>. Devolve o elemento à cabeça da fila, do tipo E, e retira-o da fila. Se a fila estiver vazia, devolve null sem esperar que seja adicionado um elemento.

A implementação da fila determina qual é o elemento à cabeça. No exemplo, ArrayDeque adiciona elementos ao fim da fila com offer() e retira-os da cabeça com poll(). A ordem é, portanto, FIFO: o primeiro a entrar é o primeiro a sair. Nem todas as filas seguem esta ordem.

peek() devolve o elemento à cabeça sem o retirar, ou devolve null se a fila estiver vazia. remove() sem argumentos devolve e retira esse elemento, mas lança NoSuchElementException se a fila estiver vazia.

Evita guardar null como elemento, mesmo que a implementação o permita: o resultado null, por si só, deixa de distinguir uma fila vazia da remoção de um elemento com o valor null. ArrayDeque não permite elementos null.

Exemplos

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

O primeiro `A` vem de `peek()`, que não retira o elemento. As duas chamadas seguintes a `poll()` retiram primeiro `A` e depois `B`. A última devolve `null` porque a fila já está vazia.

Lições relacionadas

  • Java · Lição 61 · Básico · Versão: 2

Fontes