Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori