Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Queue.offer() — Pokus o vložení prvku do fronty

`offer(E e)` se pokusí vložit prvek do fronty bez čekání na volné místo. Vrátí `true`, pokud prvek vloží, a `false`, pokud ve frontě není místo.

Verze: Java SE 21

Syntaxe

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

Queue.offer() je zkrácené označení metody, nikoli volání bez argumentů. Rozhraní java.util.Queue<E> deklaruje boolean offer(E e): E je typ prvků fronty a e je prvek předaný při volání queue.offer(e).

Metoda nečeká na uvolnění místa. Vrátí true, pokud prvek vloží, a false, pokud ve frontě není místo. Při stejném nedostatku místa metoda add(E e) vyvolá výjimku IllegalStateException. Pokud může být fronta běžně plná, kontroluj návratovou hodnotu offer. Hodnota false nenahrazuje výjimky: podle omezení fronty může metoda vyvolat NullPointerException při nepovoleném null, ClassCastException při nekompatibilním typu prvku nebo IllegalArgumentException při nepovolené vlastnosti prvku.

Ve frontě FIFO se prvky vkládají na konec; jiné implementace je mohou řadit jinak. poll() odebere a vrátí prvek z čela fronty nebo vrátí null, pokud je fronta prázdná. Přetížená varianta offer(E e, long timeout, TimeUnit unit) patří do rozhraní BlockingQueue a může čekat na místo až do vypršení zadané doby. Metoda s jedním argumentem v rozhraní Queue na volné místo nečeká.

Příklady

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

Výsledek

true
true
false
A
B

`ArrayBlockingQueue` má pevnou kapacitu 2 a používá pořadí FIFO. Prvky `A` a `B` se vloží; pokus s `C` vrátí `false`. Dvě volání `poll()` odeberou nejprve `A` a potom `B`.

Související lekce

  • Java · Lekce 61 · Základní · Verze: 2

Zdroje