Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Queue.offer() — Pokus o vloženie prvku do frontu

`offer(E e)` sa pokúsi vložiť prvok do frontu bez čakania na voľné miesto. Vráti `true`, ak prvok vloží, a `false`, ak vo fronte nie je miesto.

Verzia: Java SE 21

Syntax

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

Queue.offer() je skrátené označenie metódy, nie volanie bez argumentov. Rozhranie java.util.Queue<E> deklaruje boolean offer(E e): E je typ prvkov frontu a e je prvok odovzdaný pri volaní queue.offer(e).

Metóda nečaká na uvoľnenie miesta. Vráti true, ak prvok vloží, a false, ak vo fronte nie je miesto. Pri rovnakom nedostatku miesta metóda add(E e) vyvolá výnimku IllegalStateException. Ak je plný front bežná situácia, kontroluj návratovú hodnotu offer. Hodnota false nenahrádza výnimky: podľa obmedzení frontu môže metóda vyvolať NullPointerException pri nepovolenej hodnote null, ClassCastException pri nekompatibilnom type prvku alebo IllegalArgumentException pri nepovolenej vlastnosti prvku.

Vo fronte FIFO sa prvky vkladajú na koniec; iné implementácie ich môžu zoraďovať inak. poll() odoberie a vráti prvok z čela frontu alebo vráti null, ak je front prázdny. Preťažený variant offer(E e, long timeout, TimeUnit unit) patrí do rozhrania BlockingQueue a môže čakať na miesto až do uplynutia zadaného času. Metóda s jedným argumentom v rozhraní Queue na voľné miesto nečaká.

Prí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ýsledok

true
true
false
A
B

`ArrayBlockingQueue` má pevnú kapacitu 2 a používa poradie FIFO. Prvky `A` a `B` sa vložia; pokus s `C` vráti `false`. Dve volania `poll()` odoberú najprv `A` a potom `B`.

Súvisiace lekcie

  • Java · Lekcia 61 · Základná · Verzia: 2

Zdroje