Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

`Queue.peek()` — consulter la tête d’une file sans la retirer

La méthode `peek()` renvoie l’élément en tête d’une file sans le retirer. Si la file est vide, elle renvoie `null`.

Version : Java SE 21

Syntaxe

E peek();
// Example call on a Queue<String>:
String head = queue.peek();

Queue.peek() est une méthode d’instance de l’interface java.util.Queue<E>. Elle ne prend aucun argument et renvoie l’élément de tête, de type E, sans modifier la file. L’ordre dépend de l’implémentation : l’élément de tête n’est pas forcément celui qui a été ajouté en premier.

Si la file est vide, peek() renvoie null. La méthode element() laisse également la file intacte, mais lève une NoSuchElementException si elle est vide. La méthode poll() retire et renvoie l’élément de tête, ou renvoie null si la file est vide.

Évite d’insérer null dans la file. Si l’implémentation l’autorise, un résultat null renvoyé par peek() ne permet pas de distinguer une file vide d’une file dont l’élément de tête est null. L’exemple utilise ArrayDeque, qui n’accepte pas les éléments null.

Exemples

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());
    }
}

Résultat

apple
apple
banana
null

Le premier appel à `peek()` affiche `apple` sans le retirer. L’appel suivant à `poll()` affiche donc aussi `apple`, mais le retire. Le prochain appel à `peek()` affiche `banana`. Le second appel à `poll()` retire `banana` sans l’afficher, puis le dernier appel à `peek()` affiche `null`.

Leçons associées

  • Java · Leçon 61 · Débutant · Version : 2

Sources