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

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

Fontes