CKTIS / Java
Queue.offer() — Tenter d’insérer un élément dans une file
`offer(E e)` tente d’insérer un élément sans attendre qu’une place se libère. La méthode renvoie `true` en cas de réussite et `false` s’il n’y a pas de place.
Version : Java SE 21
Syntaxe
boolean offer(E e); // declared in java.util.Queue<E>Queue.offer() est une notation abrégée pour désigner la méthode, pas un appel sans argument. L’interface java.util.Queue<E> déclare boolean offer(E e) : E est le type des éléments de la file et e est l’élément passé dans queue.offer(e).
La méthode n’attend pas qu’une place se libère. Elle renvoie true si elle insère l’élément et false s’il n’y a pas de place. Dans les mêmes conditions, add(E e) lève une IllegalStateException. Vérifiez le résultat de offer si la file risque d’être pleine. false ne remplace pas les exceptions : selon les restrictions de la file, la méthode peut lever une NullPointerException si null est interdit, une ClassCastException si le type de l’élément est incompatible ou une IllegalArgumentException si une propriété de l’élément est interdite.
Dans une file FIFO, l’insertion se fait en fin de file ; d’autres implémentations peuvent ordonner les éléments différemment. poll() retire et renvoie l’élément en tête, ou renvoie null si la file est vide. La surcharge offer(E e, long timeout, TimeUnit unit) appartient à BlockingQueue et peut attendre qu’une place se libère, dans la limite du délai indiqué. La méthode à un argument de Queue n’attend pas qu’une place se libère.
Exemples
import java.util.Queue;
import java.util.concurrent.ArrayBlockingQueue;
public class QueueOfferExample {
public static void main(String[] args) {
Queue<String> queue = new ArrayBlockingQueue<>(2);
System.out.println(queue.offer("A"));
System.out.println(queue.offer("B"));
System.out.println(queue.offer("C"));
System.out.println(queue.poll());
System.out.println(queue.poll());
}
}Résultat
true true false A B
`ArrayBlockingQueue` a une capacité fixe de 2 et suit l’ordre FIFO. `A` et `B` sont insérés ; la tentative avec `C` renvoie `false`. Les deux appels à `poll()` retirent `A`, puis `B`.
Leçons associées
- Java · Leçon 61 · Débutant · Version : 2