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