CKTIS / Java
Queue.offer() — Tentare di inserire un elemento in una coda
`offer(E e)` tenta di inserire un elemento senza aspettare che si liberi spazio. Restituisce `true` se lo inserisce e `false` se non c’è spazio.
Versione: Java SE 21
Sintassi
boolean offer(E e); // declared in java.util.Queue<E>Queue.offer() è un modo abbreviato per indicare il metodo, non una chiamata senza argomenti. L’interfaccia java.util.Queue<E> dichiara boolean offer(E e): E è il tipo degli elementi della coda ed e è l’elemento passato in queue.offer(e).
Il metodo non aspetta che si liberi spazio. Restituisce true se inserisce l’elemento e false se non c’è posto. Nella stessa situazione, add(E e) genera una IllegalStateException. Controlla il risultato di offer se è normale che la coda si riempia. false non sostituisce le eccezioni: a seconda delle restrizioni della coda, il metodo può generare una NullPointerException se null non è ammesso, una ClassCastException se il tipo dell’elemento è incompatibile o una IllegalArgumentException se una proprietà dell’elemento non è ammessa.
In una coda FIFO, gli elementi vengono inseriti in fondo; altre implementazioni possono ordinarli diversamente. poll() rimuove e restituisce l’elemento in testa, oppure restituisce null se la coda è vuota. La variante sovraccaricata offer(E e, long timeout, TimeUnit unit) appartiene a BlockingQueue e può attendere che si liberi spazio fino allo scadere del tempo indicato. Il metodo con un solo argomento di Queue non aspetta che si liberi spazio.
Esempi
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());
}
}Risultato
true true false A B
`ArrayBlockingQueue` ha una capacità fissa di 2 e segue l’ordine FIFO. `A` e `B` vengono inseriti; il tentativo con `C` restituisce `false`. Le due chiamate a `poll()` rimuovono prima `A` e poi `B`.
Lezioni correlate
- Java · Lezione 61 · Base · Versione: 2