Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Queue.offer() — Poskus vstavljanja elementa v čakalno vrsto

`offer(E e)` poskusi vstaviti element brez čakanja na prosto mesto. Vrne `true`, če element vstavi, in `false`, če v čakalni vrsti ni prostora.

Različica: Java SE 21

Sintaksa

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

Queue.offer() je skrajšana oznaka metode, ne klic brez argumentov. Vmesnik java.util.Queue<E> deklarira boolean offer(E e): E je tip elementov čakalne vrste, e pa je element, ki ga podaš pri klicu queue.offer(e).

Metoda ne čaka na prosto mesto. Vrne true, če vstavi element, in false, če ni prostora. Ob enakem pomanjkanju prostora add(E e) sproži izjemo IllegalStateException. Če je polna čakalna vrsta pričakovan primer, preveri rezultat metode offer. Vrednost false ne nadomesti izjem: glede na omejitve čakalne vrste lahko metoda sproži NullPointerException, če null ni dovoljen, ClassCastException za nezdružljiv tip elementa ali IllegalArgumentException za nedovoljeno lastnost elementa.

V čakalni vrsti FIFO se elementi vstavljajo na konec; druge implementacije jih lahko razvrščajo drugače. poll() odstrani in vrne prvi element ali vrne null, če je čakalna vrsta prazna. Preobremenjena različica offer(E e, long timeout, TimeUnit unit) spada v vmesnik BlockingQueue in lahko na prosto mesto čaka največ toliko časa, kot je podano. Metoda z enim argumentom v vmesniku Queue ne čaka na prosto mesto.

Primeri

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 fiksno kapaciteto 2 in uporablja vrstni red FIFO. Elementa `A` in `B` se vstavita; poskus z `C` vrne `false`. Dva klica `poll()` odstranita najprej `A`, nato `B`.

Povezane lekcije

  • Java · Lekcija 61 · Osnovna · Različica: 2

Viri