IQueue インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
処理前に要素を保持するように設計されたコレクション。
[Android.Runtime.Register("java/util/Queue", "", "Java.Util.IQueueInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface IQueue : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ICollection
[<Android.Runtime.Register("java/util/Queue", "", "Java.Util.IQueueInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type IQueue = interface
interface ICollection
interface IIterable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 派生
- 属性
- 実装
注釈
処理前に要素を保持するように設計されたコレクション。 基本的な Collection
操作に加えて、キューは追加の挿入、抽出、検査操作を提供します。 これらの各メソッドは、2 つの形式で存在します。1 つは操作が失敗した場合に例外をスローし、もう 1 つは特別な値 ( null
操作に応じて または false
) を返します。 後者の形式の挿入操作は、容量制限 Queue
のある実装で使用するように特別に設計されています。ほとんどの実装では、挿入操作は失敗しません。
<table class="striped">キャプション Queue メソッド<のsummary/キャプション><thead<>tr<>td></td><th scope="col" style="font-weight:normal; font-style:italic">Throws exception</th<>th scope="col" style="font-weight:normal; font-style:italic">Returns special value</th<>/tr<>/thead><tbody><tr tr><><th scope="row">Insert</th><td>#add(Object) add(e)
</td><td><#offer(Object) offer(e)
/td></tr><tr><th scope="row">Remove</th><td><#remove() remove()
/td><td>#poll() poll()
</td></tr th><><scope="row">Examine</th<>td<#element() element()
>/td td#peek() peek()
<><>/td<>/tr></tbody></テーブル>
キューは通常、FIFO (先入れ先出し) の方法で要素を並べ替えますが、必ずしもそうであるとは限りません。 例外の中には、指定された比較器に従って要素を並べ替える優先順位キュー、または要素の自然な順序付け、および要素 LIFO (先入れ先出し) を並べ替える LIFO キュー (またはスタック) があります。 使用される順序に関係なく、<キューの em>head</em> は、 または #poll()
の#remove()
呼び出しによって削除される要素です。 FIFO キューでは、すべての新しい要素がキューの <em>tail</em> に挿入されます。 他の種類のキューでは、異なる配置規則が使用される場合があります。 すべての Queue
実装では、その順序付けプロパティを指定する必要があります。
メソッドは可能であれば 要素を挿入し、それ以外の場合は #offer offer
を返します false
。 これは、 メソッドとは java.util.Collection#add Collection.add
異なり、オフの例外をスローすることによってのみ要素を追加できません。 このメソッドは offer
、たとえば、固定容量 (または &量子で発生する場合など) ではなく、障害が正常な場合に使用するように設計されています。bounded")キュー。
メソッドと #poll()
メソッドは#remove()
、キューの先頭を削除して返します。 キューから削除される要素は、キューの順序付けポリシーの関数であり、実装によって異なります。 メソッドと poll()
メソッドはremove()
、キューが空remove()
の場合にのみ動作が異なります。メソッドは例外をスローし、メソッドは をpoll()
返しますnull
。
メソッドと #peek()
メソッドは#element()
キューの先頭を返しますが、削除しません。
インターフェイスでは Queue
、同時プログラミングで一般的な ブロッキング キュー メソッドは定義されません。 要素が表示されるのを待つ、またはスペースが使用可能になるのを待つこれらのメソッドは、 インターフェイスで java.util.concurrent.BlockingQueue
定義され、このインターフェイスが拡張されます。
Queue
の実装では通常、要素の null
挿入は許可されませんが、 などの LinkedList
一部の実装では の null
挿入は禁止されません。 それを許可する実装でも、 null
を に挿入しないでください。これは、キューにQueue
null
要素が含まれていないことを示すために、 メソッドによってpoll
特別な戻り値としても使用されます。
Queue
要素ベースのバージョンのメソッドequals
hashCode
は通常定義されず、代わりにクラス Object
から ID ベースのバージョンを継承します。これは、要素ベースの等価性が、同じ要素と異なる順序付けプロパティを持つキューに対して常に明確に定義されているわけではないためです。
1\.5 で追加されました。
の Java ドキュメント java.util.Queue
。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
プロパティ
Handle |
基になる Android オブジェクトの JNI 値を取得します。 (継承元 IJavaObject) |
IsEmpty |
要素 |
JniIdentityHashCode |
ラップされたインスタンスの の |
JniManagedPeerState |
マネージド ピアの状態。 (継承元 IJavaPeerable) |
JniPeerMembers |
メンバー アクセスと呼び出しのサポート。 (継承元 IJavaPeerable) |
PeerReference |
JniObjectReferenceラップされた Java オブジェクト インスタンスの を返します。 (継承元 IJavaPeerable) |
メソッド
Add(Object) |
容量制限に違反せずにすぐに行うことができる場合は、指定された要素をこのキューに挿入し、成功時に を返 |
AddAll(ICollection) |
指定したコレクション内のすべての要素をこのコレクションに追加します (省略可能な操作)。 (継承元 ICollection) |
Clear() |
このコレクションからすべての要素を削除します (省略可能な操作)。 (継承元 ICollection) |
Contains(Object) |
このコレクションに |
ContainsAll(ICollection) |
このコレクションに |
Disposed() |
インスタンスが破棄されたときに呼び出されます。 (継承元 IJavaPeerable) |
DisposeUnlessReferenced() |
このインスタンスへの未処理の参照がない場合は、 を呼び出 |
Element() |
このキューの先頭を取得しますが、削除しません。 |
Equals(Object) |
指定したオブジェクトとこのコレクションを比較して等しいかどうかを確認します。 (継承元 ICollection) |
Finalized() |
インスタンスが終了したときに呼び出されます。 (継承元 IJavaPeerable) |
ForEach(IConsumer) |
すべての要素が処理されるか、アクションによって例外がスローされるまで、 |
GetHashCode() |
このコレクションのハッシュ コード値を返します。 (継承元 ICollection) |
Iterator() |
このコレクション内の要素に対する反復子を返します。 (継承元 ICollection) |
Offer(Object) |
容量制限に違反せずにすぐに実行できる場合は、指定された要素をこのキューに挿入します。 |
Peek() |
このキューの先頭を取得しますが、削除しません。このキューが空の場合は を |
Poll() |
このキューの先頭を取得して削除するか、このキューが空の場合は を |
Remove() |
このキューの先頭を取得して削除します。 |
Remove(Object) |
指定した要素のインスタンスが存在する場合は、このコレクションから 1 つのインスタンスを削除します (省略可能な操作)。 (継承元 ICollection) |
RemoveAll(ICollection) |
指定したコレクションにも含まれるこのコレクションの要素をすべて削除します (省略可能な操作)。 (継承元 ICollection) |
RemoveIf(IPredicate) |
指定された述語を満たすこのコレクションのすべての要素を削除します。 (継承元 ICollection) |
RetainAll(ICollection) |
指定したコレクションに含まれるこのコレクション内の要素のみを保持します (省略可能な操作)。 (継承元 ICollection) |
SetJniIdentityHashCode(Int32) |
によって返される値を |
SetJniManagedPeerState(JniManagedPeerStates) |
処理前に要素を保持するように設計されたコレクション。 (継承元 IJavaPeerable) |
SetPeerReference(JniObjectReference) |
によって返される値を |
Size() |
このコレクション内の要素の数を返します。 (継承元 ICollection) |
Spliterator() |
|
ToArray() |
このコレクション内のすべての要素を含む配列を返します。 (継承元 ICollection) |
ToArray(IIntFunction) |
指定された関数を使用して、このコレクション内のすべての要素を含む配列を |
ToArray(Object[]) |
このコレクション内のすべての要素を含む配列を返します。返される配列のランタイム型は、指定された配列のランタイム型です。 (継承元 ICollection) |
UnregisterFromRuntime() |
ランタイムが将来 Java.Interop.JniRuntime+JniValueManager.PeekValue の呼び出しから返されないように、このインスタンスの登録を解除します。 (継承元 IJavaPeerable) |
明示的なインターフェイスの実装
IIterable.Spliterator() |
このコレクション内 |
拡張メソッド
JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
JavaCast<TResult>(IJavaObject) |
処理前に要素を保持するように設計されたコレクション。 |
GetJniTypeName(IJavaPeerable) |
処理前に要素を保持するように設計されたコレクション。 |
ToEnumerable(IIterable) |
処理前に要素を保持するように設計されたコレクション。 |
ToEnumerable<T>(IIterable) |
処理前に要素を保持するように設計されたコレクション。 |