Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Queue.offer() — Intentar insertar un elemento en una cola

`offer(E e)` intenta insertar un elemento sin esperar a que haya espacio. Devuelve `true` si lo inserta y `false` si no hay espacio disponible.

Versión: Java SE 21

Sintaxis

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

Queue.offer() es una forma abreviada de nombrar el método, no una llamada sin argumentos. La interfaz java.util.Queue<E> declara boolean offer(E e): E es el tipo de los elementos de la cola y e es el elemento que se pasa en queue.offer(e).

El método no espera a que haya espacio. Devuelve true si inserta el elemento y false si no hay sitio. Ante la misma falta de espacio, add(E e) lanza IllegalStateException. Comprueba el resultado de offer si es normal que la cola se llene. false no sustituye a las excepciones: según las restricciones de la cola, el método puede lanzar NullPointerException si no se admite null, ClassCastException si el tipo del elemento no es compatible o IllegalArgumentException si alguna propiedad del elemento no está permitida.

En una cola FIFO, los elementos se insertan al final; otras implementaciones pueden ordenarlos de otra manera. poll() elimina y devuelve el elemento del frente de la cola, o devuelve null si la cola está vacía. La sobrecarga offer(E e, long timeout, TimeUnit unit) pertenece a BlockingQueue y puede esperar a que haya espacio hasta que se agote el tiempo indicado. El método de un argumento de Queue no espera a que haya espacio.

Ejemplos

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` tiene una capacidad fija de 2 y sigue el orden FIFO. Se insertan `A` y `B`; el intento con `C` devuelve `false`. Las dos llamadas a `poll()` eliminan primero `A` y después `B`.

Lecciones relacionadas

  • Java · Lección 61 · Básico · Versión: 2

Fuentes