WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Queue.offer() — Versuchen, ein Element in eine Warteschlange einzufügen

`offer(E e)` versucht, ein Element einzufügen, ohne auf freien Platz zu warten. Die Methode liefert bei Erfolg `true` und bei Platzmangel `false`.

Version: Java SE 21

Syntax

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

Queue.offer() ist eine Kurzbezeichnung für die Methode, kein Aufruf ohne Argument. Die Schnittstelle java.util.Queue<E> deklariert boolean offer(E e): E ist der Elementtyp der Warteschlange, e das mit queue.offer(e) übergebene Element.

Die Methode wartet nicht auf freien Platz. Sie gibt true zurück, wenn sie das Element einfügt, und false, wenn kein Platz vorhanden ist. Bei demselben Platzmangel löst add(E e) eine IllegalStateException aus. Prüfe den Rückgabewert von offer, wenn eine volle Warteschlange zu erwarten ist. false ersetzt keine Ausnahmen: Je nach Einschränkungen der Warteschlange kann die Methode bei unzulässigem null eine NullPointerException, bei einem inkompatiblen Elementtyp eine ClassCastException oder bei einer unzulässigen Eigenschaft des Elements eine IllegalArgumentException auslösen.

In einer FIFO-Warteschlange werden Elemente hinten eingefügt; andere Implementierungen können eine andere Reihenfolge verwenden. poll() entfernt das vorderste Element und gibt es zurück oder liefert null, wenn die Warteschlange leer ist. Die Überladung offer(E e, long timeout, TimeUnit unit) gehört zu BlockingQueue und kann bis zum Ablauf der angegebenen Zeit auf freien Platz warten. Die Methode mit einem Argument in Queue wartet nicht auf freien Platz.

Beispiele

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

Ergebnis

true
true
false
A
B

`ArrayBlockingQueue` hat eine feste Kapazität von 2 und arbeitet nach FIFO. `A` und `B` werden eingefügt; der Versuch mit `C` liefert `false`. Die beiden Aufrufe von `poll()` entfernen zuerst `A` und dann `B`.

Zugehörige Lektionen

  • Java · Lektion 61 · Grundlagen · Version: 2

Quellen