Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła