CKTIS / Java
Queue.offer() — Pokušaj umetanja elementa u red
`offer(E e)` pokušava umetnuti element bez čekanja na slobodno mjesto. Vraća `true` ako je element umetnut i `false` ako u redu nema mjesta.
Verzija: Java SE 21
Sintaksa
boolean offer(E e); // declared in java.util.Queue<E>Queue.offer() je skraćena oznaka metode, a ne poziv bez argumenata. Sučelje java.util.Queue<E> deklarira boolean offer(E e): E je tip elemenata reda, a e je element koji predaješ u pozivu queue.offer(e).
Metoda ne čeka slobodno mjesto. Vraća true ako umetne element i false ako nema mjesta. U istom slučaju nedostatka mjesta add(E e) baca iznimku IllegalStateException. Ako je pun red očekivana situacija, provjeri rezultat metode offer. Vrijednost false ne zamjenjuje iznimke: ovisno o ograničenjima reda, metoda može baciti NullPointerException ako null nije dopušten, ClassCastException za nekompatibilan tip elementa ili IllegalArgumentException za nedopušteno svojstvo elementa.
U redu FIFO elementi se umeću na kraj; druge implementacije mogu ih poredati drukčije. poll() uklanja i vraća element s početka reda ili vraća null ako je red prazan. Preopterećena inačica offer(E e, long timeout, TimeUnit unit) pripada sučelju BlockingQueue i može čekati slobodno mjesto do isteka zadanog vremena. Metoda s jednim argumentom u sučelju Queue ne čeka slobodno mjesto.
Primjeri
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());
}
}Rezultat
true true false A B
`ArrayBlockingQueue` ima fiksni kapacitet 2 i slijedi redoslijed FIFO. Umeću se `A` i `B`; pokušaj s `C` vraća `false`. Dva poziva `poll()` uklanjaju prvo `A`, a zatim `B`.
Povezane lekcije
- Java · Lekcija 61 · Osnovno · Verzija: 2