База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Queue.offer() — Опит за добавяне на елемент в опашка

`offer(E e)` опитва да добави елемент, без да чака свободно място. Връща `true` при успешно добавяне и `false`, ако няма свободно място.

Версия: Java SE 21

Синтаксис

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

Queue.offer() е съкратено обозначение на метода, а не извикване без аргументи. Интерфейсът java.util.Queue<E> декларира boolean offer(E e): E е типът на елементите в опашката, а e е елементът, който подаваш при извикване на queue.offer(e).

Методът не чака да се освободи място. Връща true, ако добави елемента, и false, ако няма място. При същата липса на място add(E e) хвърля IllegalStateException. Ако е нормално опашката да се запълва, проверявай резултата от offer. Стойността false не замества изключенията: според ограниченията на опашката методът може да хвърли NullPointerException, ако null не е позволен, ClassCastException при несъвместим тип на елемента или IllegalArgumentException при недопустимо свойство на елемента.

В опашка FIFO елементите се добавят в края; други реализации могат да ги подреждат по различен начин. poll() премахва и връща първия елемент или връща null, ако опашката е празна. Претовареният вариант offer(E e, long timeout, TimeUnit unit) принадлежи на BlockingQueue и може да чака свободно място до изтичане на зададеното време. Методът с един аргумент в Queue не чака за свободно място.

Примери

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());
    }
}

Резултат

true
true
false
A
B

`ArrayBlockingQueue` е с фиксиран капацитет 2 и спазва реда FIFO. `A` и `B` се добавят, а опитът с `C` връща `false`. Двете извиквания на `poll()` премахват първо `A`, а след това `B`.

Свързани уроци

  • Java · Урок 61 · Начално · Версия: 2

Източници