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