Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti