KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Queue.offer() — Proberen een element aan een wachtrij toe te voegen

`offer(E e)` probeert een element toe te voegen zonder op vrije ruimte te wachten. De methode geeft `true` terug bij succes en `false` als er geen ruimte is.

Versie: Java SE 21

Syntax

boolean offer(E e);  // declared in java.util.Queue<E>

Queue.offer() is een verkorte aanduiding voor de methode, geen aanroep zonder argumenten. De interface java.util.Queue<E> declareert boolean offer(E e): E is het type van de elementen in de wachtrij en e is het element dat je meegeeft in queue.offer(e).

De methode wacht niet op vrije ruimte. Ze geeft true terug als het element wordt toegevoegd en false als er geen plek is. Bij hetzelfde ruimtegebrek werpt add(E e) een IllegalStateException. Controleer het resultaat van offer als een volle wachtrij te verwachten is. false komt niet in de plaats van uitzonderingen: afhankelijk van de beperkingen van de wachtrij kan de methode een NullPointerException werpen als null niet is toegestaan, een ClassCastException bij een incompatibel elementtype of een IllegalArgumentException bij een niet-toegestane eigenschap van het element.

In een FIFO-wachtrij worden nieuwe elementen achteraan toegevoegd; andere implementaties kunnen elementen anders ordenen. poll() verwijdert het voorste element en geeft het terug, of geeft null terug als de wachtrij leeg is. De overbelasting offer(E e, long timeout, TimeUnit unit) hoort bij BlockingQueue en kan tot de opgegeven tijdslimiet wachten op vrije ruimte. De methode met één argument in Queue wacht niet op vrije ruimte.

Voorbeelden

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

Resultaat

true
true
false
A
B

`ArrayBlockingQueue` heeft een vaste capaciteit van 2 en gebruikt de FIFO-volgorde. `A` en `B` worden toegevoegd; de poging met `C` geeft `false` terug. De twee aanroepen van `poll()` verwijderen eerst `A` en daarna `B`.

Gerelateerde lessen

  • Java · Les 61 · Basis · Versie: 2

Bronnen