CKTIS / Java
`Queue.peek()` — consultar o início da fila sem remover o elemento
O método `peek()` devolve o elemento no início da fila sem o remover. Se a fila estiver vazia, devolve `null`.
Versão: Java SE 21
Sintaxe
E peek();
// Example call on a Queue<String>:
String head = queue.peek();Queue.peek() é um método de instância da interface java.util.Queue<E>. Não recebe argumentos e devolve o elemento no início da fila, do tipo E, sem alterar a fila. A ordem depende da implementação: o elemento no início não é necessariamente o que foi inserido primeiro.
Se a fila estiver vazia, peek() devolve null. O método element() também não altera a fila, mas lança NoSuchElementException se estiver vazia. O método poll() remove e devolve o elemento no início da fila, ou devolve null se a fila estiver vazia.
Evita inserir null como elemento. Se a implementação o permitir, um resultado null de peek() não permite distinguir uma fila vazia de uma fila com null no início. O exemplo usa ArrayDeque, que não aceita 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("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
A primeira chamada a `peek()` escreve `apple` na consola sem o remover. Por isso, a chamada seguinte a `poll()` também escreve `apple`, mas remove-o. A próxima chamada a `peek()` escreve `banana`. A segunda chamada a `poll()` remove `banana` sem o escrever, e a última chamada a `peek()` escreve `null`.
Lições relacionadas
- Java · Lição 61 · Básico · Versão: 2