CKTIS / Java
Queue.poll() — retirer et renvoyer l’élément en tête de file
`Queue.poll()` retire et renvoie l’élément en tête de file. Si la file est vide, la méthode renvoie `null` au lieu de lever une exception.
Version : Java SE 21
Syntaxe
E poll();
// Call on a Queue<E> instance:
E head = queue.poll();Queue.poll() est une méthode sans argument de l’interface java.util.Queue<E>. Elle renvoie l’élément de tête, de type E, et le retire de la file. Si la file est vide, la méthode renvoie null sans attendre l’ajout d’un élément.
L’implémentation de la file détermine quel élément se trouve en tête. Dans l’exemple, ArrayDeque ajoute les éléments en fin de file avec offer() et les retire en tête avec poll(). L’ordre est donc FIFO : premier entré, premier sorti. Toutes les files ne suivent pas cet ordre.
peek() renvoie l’élément de tête sans le retirer, ou null si la file est vide. Sans argument, remove() retire et renvoie l’élément de tête, mais lève NoSuchElementException si la file est vide.
Évitez de stocker null comme élément, même si l’implémentation l’autorise : le résultat null ne permet alors pas à lui seul de distinguer une file vide du retrait d’un élément valant null. ArrayDeque 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("A");
queue.offer("B");
System.out.println(queue.peek());
System.out.println(queue.poll());
System.out.println(queue.poll());
System.out.println(queue.poll());
}
}Résultat
A A B null
Le premier `A` est renvoyé par `peek()`, qui laisse l’élément dans la file. Les deux appels suivants à `poll()` retirent d’abord `A`, puis `B`. Le dernier appel renvoie `null`, car la file est désormais vide.
Leçons associées
- Java · Leçon 61 · Débutant · Version : 2