`Queue.offer` în Java

Cozi și stive (Queue, Deque, PriorityQueue) Java 5

offer pune un element la coada cozii, poll îl scoate pe primul (sau dă null), peek îl arată pe primul fără să-l scoată.

Sintaxă

boolean offer(E e)   // adaugă la coadă
E poll()             // scoate din față sau null
E peek()             // primul, fără să-l scoată, sau null

boolean add(E e)     // la fel, dar cu excepții
E remove()
E element()

Ce face `Queue.offer`

offer(x) adaugă x la sfârșitul cozii și returnează true. Returnează false doar la cozile cu capacitate limitată care sunt pline (de exemplu ArrayBlockingQueue); la ArrayDeque și LinkedList reușește mereu.

poll() scoate și returnează primul element; pe o coadă goală returnează null. peek() returnează primul element fără să-l scoată, tot null pe coadă goală.

Perechile cu excepții sunt add (aruncă IllegalStateException dacă e plină), remove() și element() (aruncă NoSuchElementException dacă e goală).

Parametri

Parametru	Descriere
`e`	Elementul adăugat (fără `null` la `ArrayDeque`).

Ce returnează

offer: boolean. poll, peek: elementul sau null.

Exemple

Exemplul 1: Comenzi la imprimantă

import java.util.ArrayDeque;
import java.util.Queue;

public class Main {
    public static void main(String[] args) {
        Queue<String> tiparire = new ArrayDeque<>();
        tiparire.offer("factura_101.pdf");
        tiparire.offer("contract.docx");
        System.out.println("Urmează: " + tiparire.peek());
        System.out.println("Tipărit: " + tiparire.poll());
        System.out.println("Tipărit: " + tiparire.poll());
        System.out.println("Tipărit: " + tiparire.poll());
        System.out.println("Urmează: " + tiparire.peek());
    }
}

Rezultat

Urmează: factura_101.pdf
Tipărit: factura_101.pdf
Tipărit: contract.docx
Tipărit: null
Urmează: null

Exemplul 2: Coadă cu capacitate limitată

ArrayBlockingQueue are loc pentru 2 elemente: al treilea offer returnează false, iar add aruncă excepție.

import java.util.Queue;
import java.util.concurrent.ArrayBlockingQueue;

public class Main {
    public static void main(String[] args) {
        Queue<String> locuri = new ArrayBlockingQueue<>(2);
        System.out.println(locuri.offer("Ana"));
        System.out.println(locuri.offer("Radu"));
        System.out.println(locuri.offer("Elena"));
        try {
            locuri.add("Mihai");
        } catch (IllegalStateException e) {
            System.out.println("add: IllegalStateException, coada e plină");
        }
        System.out.println(locuri);
    }
}