java.util.concurrent

Соедините интерфейсом с BlockingDeque <E>

Введите Параметры:

E - тип элементов сохранен в этом наборе

Все Суперинтерфейсы:

BlockingQueue <E>, Набор <E>, Двухсторонняя очередь <E>, Повторяемый <E>, Очередь <E>

Все Известные Классы с реализацией:

LinkedBlockingDeque

public interface BlockingDeque<E>
extends BlockingQueue<E>, Deque<E>

A Deque это дополнительно поддерживает операции блокирования, которые ожидают двухсторонней очереди, чтобы стать непустыми, получая элемент, и ожидать пространства, чтобы стать доступными в двухсторонней очереди, храня элемент.

Методы BlockingDeque, прибывшие в четыре формы, с различными способами погрузочно-разгрузочных работ, которые не могут быть сразу удовлетворены, но могут быть удовлетворены в некоторый момент в будущем: каждый выдает исключение, вторые возвраты специальное значение (или null или false, в зависимости от работы), третьи блоки текущий поток неопределенно, пока работа не может успешно выполниться, и четвертые блоки для только данного максимального ограничения по времени перед отказом. Эти методы получаются в итоге в следующей таблице:

Первый Элемент (Голова)
	Выдает исключение	Специальное значение	Блоки	Времена
Вставить	addFirst(e)	offerFirst(e)	putFirst(e)	offerFirst(e, time, unit)
Удалить	removeFirst()	pollFirst()	takeFirst()	pollFirst(time, unit)
Исследовать	getFirst()	peekFirst()	не применимый	не применимый
Последний Элемент (Хвост)
	Выдает исключение	Специальное значение	Блоки	Времена
Вставить	addLast(e)	offerLast(e)	putLast(e)	offerLast(e, time, unit)
Удалить	removeLast()	pollLast()	takeLast()	pollLast(time, unit)
Исследовать	getLast()	peekLast()	не применимый	не применимый

Как любой BlockingQueue, BlockingDeque ориентирован на многопотоковое исполнение, не разрешает нулевые элементы, и может (или не может) быть ограниченным емкостью.

Реализация BlockingDeque может использоваться непосредственно в качестве FIFO BlockingQueue. Методы, наследованные от интерфейса BlockingQueue, точно эквивалентны методам BlockingDeque как обозначено в следующей таблице:

Метод BlockingQueue	Эквивалентный Метод BlockingDeque
Вставить
add(e)	addLast(e)
offer(e)	offerLast(e)
put(e)	putLast(e)
offer(e, time, unit)	offerLast(e, time, unit)
Удалить
remove()	removeFirst()
poll()	pollFirst()
take()	takeFirst()
poll(time, unit)	pollFirst(time, unit)
Исследовать
element()	getFirst()
peek()	peekFirst()

Эффекты непротиворечивости памяти: Как с другими параллельными наборами, действиями в потоке до размещения объекта в a BlockingDeque произойдите - перед действиями, последующими за доступом или удалением того элемента от BlockingDeque в другом потоке.

Этот интерфейс является элементом Платформы Наборов Java.

С тех пор:

1.6

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
boolean	add(E e) Вставляет указанный элемент в очередь, представленную этой двухсторонней очередью (другими словами, в хвосте этой двухсторонней очереди), если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и бросая IllegalStateException, если никакое пространство не в настоящий момент доступно.
void	addFirst(E e) Вставляет указанный элемент впереди этой двухсторонней очереди, если возможно сделать так сразу, не нарушая ограничения емкости, бросая IllegalStateException, если никакое пространство не в настоящий момент доступно.
void	addLast(E e) Вставляет указанный элемент в конце этой двухсторонней очереди, если возможно сделать так сразу, не нарушая ограничения емкости, бросая IllegalStateException, если никакое пространство не в настоящий момент доступно.
boolean	contains(Object o) true возвратов, если эта двухсторонняя очередь содержит указанный элемент.
E	element() Получает, но не удаляет, глава очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди).
Iterator<E>	iterator() Возвращает iterator по элементам в этой двухсторонней очереди в надлежащей последовательности.
boolean	offer(E e) Вставляет указанный элемент в очередь, представленную этой двухсторонней очередью (другими словами, в хвосте этой двухсторонней очереди), если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и false, если никакое пространство не в настоящий момент доступно.
boolean	offer(E e, long timeout, TimeUnit unit) Вставляет указанный элемент в очередь, представленную этой двухсторонней очередью (другими словами, в хвосте этой двухсторонней очереди), дожидаясь к указанному времени ожидания в случае необходимости для пространства, чтобы стать доступным.
boolean	offerFirst(E e) Вставляет указанный элемент впереди этой двухсторонней очереди, если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и false, если никакое пространство не в настоящий момент доступно.
boolean	offerFirst(E e, long timeout, TimeUnit unit) Вставляет указанный элемент впереди этой двухсторонней очереди, дожидаясь к указанному времени ожидания в случае необходимости для пространства, чтобы стать доступным.
boolean	offerLast(E e) Вставляет указанный элемент в конце этой двухсторонней очереди, если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и false, если никакое пространство не в настоящий момент доступно.
boolean	offerLast(E e, long timeout, TimeUnit unit) Вставляет указанный элемент в конце этой двухсторонней очереди, дожидаясь к указанному времени ожидания в случае необходимости для пространства, чтобы стать доступным.
E	peek() Получает, но не удаляет, глава очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди), или возвращает null, если эта двухсторонняя очередь пуста.
E	poll() Получает и удаляет главу очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди), или возвращает null, если эта двухсторонняя очередь пуста.
E	poll(long timeout, TimeUnit unit) Получает и удаляет главу очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди), дожидаясь к указанному времени ожидания в случае необходимости для элемента, чтобы стать доступным.
E	pollFirst(long timeout, TimeUnit unit) Получает и удаляет первый элемент этой двухсторонней очереди, дожидаясь к указанному времени ожидания в случае необходимости для элемента, чтобы стать доступным.
E	pollLast(long timeout, TimeUnit unit) Получает и удаляет последний элемент этой двухсторонней очереди, дожидаясь к указанному времени ожидания в случае необходимости для элемента, чтобы стать доступным.
void	push(E e) Продвигает элемент на стек, представленный этой двухсторонней очередью.
void	put(E e) Вставляет указанный элемент в очередь, представленную этой двухсторонней очередью (другими словами, в хвосте этой двухсторонней очереди), ожидая в случае необходимости пространства, чтобы стать доступным.
void	putFirst(E e) Вставляет указанный элемент впереди этой двухсторонней очереди, ожидая в случае необходимости пространства, чтобы стать доступным.
void	putLast(E e) Вставляет указанный элемент в конце этой двухсторонней очереди, ожидая в случае необходимости пространства, чтобы стать доступным.
E	remove() Получает и удаляет главу очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди).
boolean	remove(Object o) Удаляет первое возникновение указанного элемента от этой двухсторонней очереди.
boolean	removeFirstOccurrence(Object o) Удаляет первое возникновение указанного элемента от этой двухсторонней очереди.
boolean	removeLastOccurrence(Object o) Удаляет последнее вхождение указанного элемента от этой двухсторонней очереди.
int	size() Возвращает число элементов в этой двухсторонней очереди.
E	take() Получает и удаляет главу очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди), ожидая в случае необходимости, пока элемент не становится доступным.
E	takeFirst() Получает и удаляет первый элемент этой двухсторонней очереди, ожидая в случае необходимости, пока элемент не становится доступным.
E	takeLast() Получает и удаляет последний элемент этой двухсторонней очереди, ожидая в случае необходимости, пока элемент не становится доступным.

Методы, наследованные от интерфейса java.util.concurrent. BlockingQueue

drainTo, drainTo, remainingCapacity

Методы, наследованные от интерфейса java.util. Двухсторонняя очередь

descendingIterator, getFirst, getLast, peekFirst, peekLast, pollFirst, pollLast, pop, removeFirst, removeLast

Методы, наследованные от интерфейса java.util. Набор

addAll, clear, containsAll, equals, hashCode, isEmpty, removeAll, retainAll, toArray, toArray

Деталь метода

addFirst

void addFirst(E e)

Вставляет указанный элемент впереди этой двухсторонней очереди, если возможно сделать так сразу, не нарушая ограничения емкости, бросая IllegalStateException, если никакое пространство не в настоящий момент доступно. При использовании ограниченной емкостью двухсторонней очереди обычно предпочтительно использовать offerFirst.

Определенный:

addFirst в интерфейсе Deque<E>

Параметры:

e - элемент, чтобы добавить

Броски:

IllegalStateException - если элемент не может быть добавлен в это время из-за ограничений емкости

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

addLast

void addLast(E e)

Вставляет указанный элемент в конце этой двухсторонней очереди, если возможно сделать так сразу, не нарушая ограничения емкости, бросая IllegalStateException, если никакое пространство не в настоящий момент доступно. При использовании ограниченной емкостью двухсторонней очереди обычно предпочтительно использовать offerLast.

Определенный:

addLast в интерфейсе Deque<E>

Параметры:

e - элемент, чтобы добавить

Броски:

IllegalStateException - если элемент не может быть добавлен в это время из-за ограничений емкости

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

offerFirst

boolean offerFirst(E e)

Вставляет указанный элемент впереди этой двухсторонней очереди, если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и false, если никакое пространство не в настоящий момент доступно. При использовании ограниченной емкостью двухсторонней очереди этот метод обычно предпочтителен для addFirst метод, который может быть не в состоянии вставить элемент только, выдавая исключение.

Определенный:

offerFirst в интерфейсе Deque<E>

Параметры:

e - элемент, чтобы добавить

Возвраты:

true, если элемент был добавлен к этой двухсторонней очереди, еще false

Броски:

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

offerLast

boolean offerLast(E e)

Вставляет указанный элемент в конце этой двухсторонней очереди, если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и false, если никакое пространство не в настоящий момент доступно. При использовании ограниченной емкостью двухсторонней очереди этот метод обычно предпочтителен для addLast метод, который может быть не в состоянии вставить элемент только, выдавая исключение.

Определенный:

offerLast в интерфейсе Deque<E>

Параметры:

e - элемент, чтобы добавить

Возвраты:

true, если элемент был добавлен к этой двухсторонней очереди, еще false

Броски:

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

putFirst

void putFirst(E e)
              throws InterruptedException

Вставляет указанный элемент впереди этой двухсторонней очереди, ожидая в случае необходимости пространства, чтобы стать доступным.

Параметры:

e - элемент, чтобы добавить

Броски:

InterruptedException - если прервано, ожидая

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

putLast

void putLast(E e)
             throws InterruptedException

Вставляет указанный элемент в конце этой двухсторонней очереди, ожидая в случае необходимости пространства, чтобы стать доступным.

Параметры:

e - элемент, чтобы добавить

Броски:

InterruptedException - если прервано, ожидая

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

offerFirst

boolean offerFirst(E e,
                 long timeout,
                 TimeUnit unit)
                   throws InterruptedException

Вставляет указанный элемент впереди этой двухсторонней очереди, дожидаясь к указанному времени ожидания в случае необходимости для пространства, чтобы стать доступным.

Параметры:

e - элемент, чтобы добавить

timeout - сколько времени ожидать перед отказом в модулях unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвраты:

true в случае успеха, или false, если указанное время ожидания протекает перед пространством, доступен

Броски:

InterruptedException - если прервано, ожидая

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

offerLast

boolean offerLast(E e,
                long timeout,
                TimeUnit unit)
                  throws InterruptedException

Вставляет указанный элемент в конце этой двухсторонней очереди, дожидаясь к указанному времени ожидания в случае необходимости для пространства, чтобы стать доступным.

Параметры:

e - элемент, чтобы добавить

timeout - сколько времени ожидать перед отказом в модулях unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвраты:

true в случае успеха, или false, если указанное время ожидания протекает перед пространством, доступен

Броски:

InterruptedException - если прервано, ожидая

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

takeFirst

E takeFirst()
            throws InterruptedException

Получает и удаляет первый элемент этой двухсторонней очереди, ожидая в случае необходимости, пока элемент не становится доступным.

Возвраты:

глава этой двухсторонней очереди

Броски:

InterruptedException - если прервано, ожидая

takeLast

E takeLast()
           throws InterruptedException

Получает и удаляет последний элемент этой двухсторонней очереди, ожидая в случае необходимости, пока элемент не становится доступным.

Возвраты:

хвост этой двухсторонней очереди

Броски:

InterruptedException - если прервано, ожидая

pollFirst

E pollFirst(long timeout,
          TimeUnit unit)
            throws InterruptedException

Получает и удаляет первый элемент этой двухсторонней очереди, дожидаясь к указанному времени ожидания в случае необходимости для элемента, чтобы стать доступным.

Параметры:

timeout - сколько времени ожидать перед отказом в модулях unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвраты:

глава этой двухсторонней очереди, или null, если указанное время ожидания протекает перед элементом, доступны

Броски:

InterruptedException - если прервано, ожидая

pollLast

E pollLast(long timeout,
         TimeUnit unit)
           throws InterruptedException

Получает и удаляет последний элемент этой двухсторонней очереди, дожидаясь к указанному времени ожидания в случае необходимости для элемента, чтобы стать доступным.

Параметры:

timeout - сколько времени ожидать перед отказом в модулях unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвраты:

хвост этой двухсторонней очереди, или null, если указанное время ожидания протекает перед элементом, доступен

Броски:

InterruptedException - если прервано, ожидая

removeFirstOccurrence

boolean removeFirstOccurrence(Object o)

Удаляет первое возникновение указанного элемента от этой двухсторонней очереди. Если двухсторонняя очередь не содержит элемент, это неизменно. Более формально, удаляет первый элемент e так, что o.equals(e) (если такой элемент существует). Возвраты true, если эта двухсторонняя очередь, содержавшая указанный элемент (или эквивалентно, если эта двухсторонняя очередь, измененная в результате вызова).

Определенный:

removeFirstOccurrence в интерфейсе Deque<E>

Параметры:

o - элемент, который будет удален из этой двухсторонней очереди, если существующий

Возвраты:

true, если элемент был удален в результате этого вызова

Броски:

ClassCastException - если класс указанного элемента является несовместимым с этой (дополнительной) двухсторонней очередью

NullPointerException - если указанный элемент является (дополнительным) нулем

removeLastOccurrence

boolean removeLastOccurrence(Object o)

Удаляет последнее вхождение указанного элемента от этой двухсторонней очереди. Если двухсторонняя очередь не содержит элемент, это неизменно. Более формально, удаляет последний элемент e так, что o.equals(e) (если такой элемент существует). Возвраты true, если эта двухсторонняя очередь, содержавшая указанный элемент (или эквивалентно, если эта двухсторонняя очередь, измененная в результате вызова).

Определенный:

removeLastOccurrence в интерфейсе Deque<E>

Параметры:

o - элемент, который будет удален из этой двухсторонней очереди, если существующий

Возвраты:

true, если элемент был удален в результате этого вызова

Броски:

ClassCastException - если класс указанного элемента является несовместимым с этой (дополнительной) двухсторонней очередью

NullPointerException - если указанный элемент является (дополнительным) нулем

добавить

boolean add(E e)

Вставляет указанный элемент в очередь, представленную этой двухсторонней очередью (другими словами, в хвосте этой двухсторонней очереди), если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и бросая IllegalStateException, если никакое пространство не в настоящий момент доступно. При использовании ограниченной емкостью двухсторонней очереди обычно предпочтительно использовать offer.

Этот метод эквивалентен addLast.

Определенный:

add в интерфейсе BlockingQueue<E>

Определенный:

add в интерфейсе Collection<E>

Определенный:

add в интерфейсе Deque<E>

Определенный:

add в интерфейсе Queue<E>

Параметры:

e - элемент, чтобы добавить

Возвраты:

true (как определено Collection.add(E))

Броски:

IllegalStateException - если элемент не может быть добавлен в это время из-за ограничений емкости

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

предложение

boolean offer(E e)

Вставляет указанный элемент в очередь, представленную этой двухсторонней очередью (другими словами, в хвосте этой двухсторонней очереди), если возможно сделать так сразу, не нарушая ограничения емкости, возвращая true на успех и false, если никакое пространство не в настоящий момент доступно. При использовании ограниченной емкостью двухсторонней очереди этот метод обычно предпочтителен для add(E) метод, который может быть не в состоянии вставить элемент только, выдавая исключение.

Этот метод эквивалентен offerLast.

Определенный:

offer в интерфейсе BlockingQueue<E>

Определенный:

offer в интерфейсе Deque<E>

Определенный:

offer в интерфейсе Queue<E>

Параметры:

e - элемент, чтобы добавить

Возвраты:

true, если элемент был добавлен к этой очереди, еще false

Броски:

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

поместить

void put(E e)
         throws InterruptedException

Вставляет указанный элемент в очередь, представленную этой двухсторонней очередью (другими словами, в хвосте этой двухсторонней очереди), ожидая в случае необходимости пространства, чтобы стать доступным.

Этот метод эквивалентен putLast.

Определенный:

put в интерфейсе BlockingQueue<E>

Параметры:

e - элемент, чтобы добавить

Броски:

InterruptedException - если прервано, ожидая

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

предложение

boolean offer(E e,
            long timeout,
            TimeUnit unit)
              throws InterruptedException

Вставляет указанный элемент в очередь, представленную этой двухсторонней очередью (другими словами, в хвосте этой двухсторонней очереди), дожидаясь к указанному времени ожидания в случае необходимости для пространства, чтобы стать доступным.

Этот метод эквивалентен offerLast.

Определенный:

offer в интерфейсе BlockingQueue<E>

Параметры:

e - элемент, чтобы добавить

timeout - сколько времени ожидать перед отказом в модулях unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвраты:

true, если элемент был добавлен к этой двухсторонней очереди, еще false

Броски:

InterruptedException - если прервано, ожидая

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

удалить

E remove()

Получает и удаляет главу очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди). Этот метод отличается от poll только в этом это выдает исключение, если эта двухсторонняя очередь пуста.

Этот метод эквивалентен removeFirst.

Определенный:

remove в интерфейсе Deque<E>

Определенный:

remove в интерфейсе Queue<E>

Возвраты:

глава очереди представляется этой двухсторонней очередью

Броски:

NoSuchElementException - если эта двухсторонняя очередь пуста

опрос

E poll()

Получает и удаляет главу очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди), или возвращает null, если эта двухсторонняя очередь пуста.

Этот метод эквивалентен Deque.pollFirst().

Определенный:

poll в интерфейсе Deque<E>

Определенный:

poll в интерфейсе Queue<E>

Возвраты:

глава этой двухсторонней очереди, или null, если эта двухсторонняя очередь пуста

взять

E take()
       throws InterruptedException

Получает и удаляет главу очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди), ожидая в случае необходимости, пока элемент не становится доступным.

Этот метод эквивалентен takeFirst.

Определенный:

take в интерфейсе BlockingQueue<E>

Возвраты:

глава этой двухсторонней очереди

Броски:

InterruptedException - если прервано, ожидая

опрос

E poll(long timeout,
     TimeUnit unit)
       throws InterruptedException

Получает и удаляет главу очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди), дожидаясь к указанному времени ожидания в случае необходимости для элемента, чтобы стать доступным.

Этот метод эквивалентен pollFirst.

Определенный:

poll в интерфейсе BlockingQueue<E>

Параметры:

timeout - сколько времени ожидать перед отказом в модулях unit

unit - TimeUnit, определяющий, как интерпретировать параметр timeout

Возвраты:

глава этой двухсторонней очереди, или null, если указанное время ожидания протекает перед элементом, доступны

Броски:

InterruptedException - если прервано, ожидая

элемент

E element()

Получает, но не удаляет, глава очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди). Этот метод отличается от peek только в этом это выдает исключение, если эта двухсторонняя очередь пуста.

Этот метод эквивалентен getFirst.

Определенный:

element в интерфейсе Deque<E>

Определенный:

element в интерфейсе Queue<E>

Возвраты:

глава этой двухсторонней очереди

Броски:

NoSuchElementException - если эта двухсторонняя очередь пуста

быстрый взгляд

E peek()

Получает, но не удаляет, глава очереди, представленной этой двухсторонней очередью (другими словами, первый элемент этой двухсторонней очереди), или возвращает null, если эта двухсторонняя очередь пуста.

Этот метод эквивалентен peekFirst.

Определенный:

peek в интерфейсе Deque<E>

Определенный:

peek в интерфейсе Queue<E>

Возвраты:

глава этой двухсторонней очереди, или null, если эта двухсторонняя очередь пуста

удалить

boolean remove(Object o)

Удаляет первое возникновение указанного элемента от этой двухсторонней очереди. Если двухсторонняя очередь не содержит элемент, это неизменно. Более формально, удаляет первый элемент e так, что o.equals(e) (если такой элемент существует). Возвраты true, если эта двухсторонняя очередь, содержавшая указанный элемент (или эквивалентно, если эта двухсторонняя очередь, измененная в результате вызова).

Этот метод эквивалентен removeFirstOccurrence.

Определенный:

remove в интерфейсе BlockingQueue<E>

Определенный:

remove в интерфейсе Collection<E>

Определенный:

remove в интерфейсе Deque<E>

Параметры:

o - элемент, который будет удален из этой двухсторонней очереди, если существующий

Возвраты:

true, если эта двухсторонняя очередь изменилась в результате вызова

Броски:

ClassCastException - если класс указанного элемента является несовместимым с этой (дополнительной) двухсторонней очередью

NullPointerException - если указанный элемент является (дополнительным) нулем

содержит

boolean contains(Object o)

true возвратов, если эта двухсторонняя очередь содержит указанный элемент. Более формально, возвраты true, если и только если эта двухсторонняя очередь содержит по крайней мере один элемент e так, что o.equals(e).

Определенный:

contains в интерфейсе BlockingQueue<E>

Определенный:

contains в интерфейсе Collection<E>

Определенный:

contains в интерфейсе Deque<E>

Параметры:

o - объект, который будет проверен на включение в этой двухсторонней очереди

Возвраты:

true, если эта двухсторонняя очередь содержит указанный элемент

Броски:

ClassCastException - если класс указанного элемента является несовместимым с этой (дополнительной) двухсторонней очередью

NullPointerException - если указанный элемент является (дополнительным) нулем

размер

int size()

Возвращает число элементов в этой двухсторонней очереди.

Определенный:

size в интерфейсе Collection<E>

Определенный:

size в интерфейсе Deque<E>

Возвраты:

число элементов в этой двухсторонней очереди

iterator

Iterator<E> iterator()

Возвращает iterator по элементам в этой двухсторонней очереди в надлежащей последовательности. Элементы будут возвращены в порядке от первого (голова), чтобы продлиться (хвост).

Определенный:

iterator в интерфейсе Collection<E>

Определенный:

iterator в интерфейсе Deque<E>

Определенный:

iterator в интерфейсе Iterable<E>

Возвраты:

iterator по элементам в этой двухсторонней очереди в надлежащей последовательности

продвинуть

void push(E e)

Продвигает элемент на стек, представленный этой двухсторонней очередью. Другими словами, вставляет элемент впереди этой двухсторонней очереди, если это не нарушило бы ограничения емкости.

Этот метод эквивалентен addFirst.

Определенный:

push в интерфейсе Deque<E>

Параметры:

e - элемент, чтобы продвинуть

Броски:

IllegalStateException - если элемент не может быть добавлен в это время из-за ограничений емкости

ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди

NullPointerException - если указанный элемент является нулем

IllegalArgumentException - если некоторое свойство указанного элемента препятствует тому, чтобы это было добавлено к этой двухсторонней очереди