CKTIS / Java
Queue.offer() — próba dodania elementu do kolejki
Metoda `offer(E e)` próbuje dodać element do kolejki bez czekania na wolne miejsce. Zwraca `true` po dodaniu i `false`, gdy brakuje miejsca.
Wersja: Java SE 21
Składnia
boolean offer(E e); // declared in java.util.Queue<E>Zapis Queue.offer() to skrótowa nazwa metody, a nie wywołanie bez argumentów. Interfejs java.util.Queue<E> deklaruje boolean offer(E e): E oznacza typ elementów kolejki, a e to element przekazywany w wywołaniu queue.offer(e).
Metoda nie czeka na wolne miejsce. Zwraca true, jeśli dodała element, albo false, jeśli nie mogła go dodać z powodu braku miejsca. W tej samej sytuacji add(E e) zgłasza IllegalStateException. Sprawdzaj wynik offer, jeśli brak miejsca jest spodziewany. false nie zastępuje wyjątków: zależnie od ograniczeń kolejki metoda może zgłosić NullPointerException dla niedozwolonego null, ClassCastException dla nieakceptowanego typu elementu lub IllegalArgumentException z powodu niedozwolonej cechy elementu.
W kolejce FIFO element trafia na koniec; inne implementacje mogą ustalać kolejność inaczej. poll() usuwa i zwraca element z początku kolejki, a gdy kolejka jest pusta, zwraca null. Wariant offer(E e, long timeout, TimeUnit unit) należy do BlockingQueue i może czekać na miejsce do upływu podanego czasu. Jednoargumentowa metoda interfejsu Queue nie czeka na miejsce.
Przykłady
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());
}
}Wynik
true true false A B
`ArrayBlockingQueue` ma stałą pojemność równą 2 i działa w kolejności FIFO. `A` i `B` zostają dodane, a próba dodania `C` zwraca `false`. Dwa wywołania `poll()` usuwają kolejno `A` i `B`.
Powiązane lekcje
- Java · Lekcja 61 · Podstawowy · Wersja: 2