Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes