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