CKTIS / Java
Queue.offer() — Tentar inserir um elemento numa fila
`offer(E e)` tenta inserir um elemento sem esperar que haja espaço. Devolve `true` se o elemento for inserido e `false` se não houver espaço disponível.
Versão: Java SE 21
Sintaxe
boolean offer(E e); // declared in java.util.Queue<E>Queue.offer() é uma forma abreviada de identificar o método, não uma chamada sem argumentos. A interface java.util.Queue<E> declara boolean offer(E e): E é o tipo dos elementos da fila e e é o elemento passado em queue.offer(e).
O método não espera que haja espaço. Devolve true se inserir o elemento e false se não houver espaço. Perante a mesma falta de espaço, add(E e) lança IllegalStateException. Verifica o resultado de offer se for normal a fila ficar cheia. false não substitui as exceções: consoante as restrições da fila, o método pode lançar NullPointerException se null não for permitido, ClassCastException se o tipo do elemento for incompatível ou IllegalArgumentException se alguma propriedade do elemento não for permitida.
Numa fila FIFO, os elementos são inseridos no fim; outras implementações podem ordená-los de outra forma. poll() remove e devolve o elemento à frente da fila, ou devolve null se a fila estiver vazia. A sobrecarga offer(E e, long timeout, TimeUnit unit) pertence a BlockingQueue e pode esperar por espaço até ao limite de tempo indicado. O método de um argumento de Queue não espera que haja espaço.
Exemplos
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());
}
}Resultado
true true false A B
`ArrayBlockingQueue` tem capacidade fixa de 2 e segue a ordem FIFO. `A` e `B` são inseridos; a tentativa com `C` devolve `false`. As duas chamadas a `poll()` removem primeiro `A` e depois `B`.
Lições relacionadas
- Java · Lição 61 · Básico · Versão: 2