java.util
インタフェース Queue<E>

すべてのスーパーインタフェース:

Collection<E>, Iterable<E>

既知の実装クラスの一覧:

AbstractQueue

public interface Queue<E>
extends Collection<E>

Queue インタフェースは Collection に FIFO（first-in-first-out）のアクセスを定義します。

Queue の poll() メソッドでは、要素が無いことを示す場合に null を返します。 そのため Queue では要素として null を許容しません。

Queue インタフェースは、ブロッキングキュー用のメソッドを定義していません。 ブロッキングキューは、キューに要素が追加されるまで、またはキューに空き容量ができるまでメソッドをブロックする機能を持ち、並行プログラミングでよく使用されます。

メソッドの概要

boolean	offer(E e) 指定された要素をキューに挿入します。
E	poll() キューの最初の要素を除去して返します。
E	remove() キューの最初の要素を除去して返します。

インタフェース java.util.Collection から継承されたメソッド

add, clear, contains, isEmpty, iterator, remove, size, toArray

メソッドの詳細

offer

boolean offer(E e)

指定された要素をキューに挿入します。

このメソッドの振る舞いは Collection.add(E) に類似していますが、Collection#add が失敗する場合には例外をスローするのに対して、このメソッドは false を返します。 一般に、容量に制限のあるキューに対して挿入する場合には、容量を超過した場合に例外をスローするよりも false を返すほうが好まれる傾向があります。

パラメータ:

e - 挿入する要素

戻り値:

処理に成功した場合 true、失敗した場合 false

poll

E poll()

キューの最初の要素を除去して返します。

戻り値:

キューの最初の要素。 キューに要素が無い場合 null 。

remove

E remove()

キューの最初の要素を除去して返します。

戻り値:

キューの最初の要素。

例外:

NoSuchElementException - キューに要素が無い場合