IQueue 介面

參考

定義

命名空間:: Java.Util

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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

衍生: Java.Util.AbstractQueue

Java.Util.ArrayDeque

Java.Util.Concurrent.ArrayBlockingQueue

Java.Util.Concurrent.ConcurrentLinkedDeque

Java.Util.Concurrent.ConcurrentLinkedQueue

更多…

屬性: RegisterAttribute JavaTypeParametersAttribute

實作: IJavaObject IJavaPeerable IIterable ICollection IDisposable

備註

集合，其設計目的是在處理之前存放元素。除了基本 Collection 作業之外，佇列還提供額外的插入、擷取和檢查作業。每一種方法都以兩種形式存在：一種在作業失敗時擲回例外狀況，另一種方法會傳回特殊值（ null 或 false，視作業而定）。插入作業的後一種形式是特別設計來搭配容量限制 Queue 實作使用;在大部分的實作中，插入作業無法失敗。

<table class=“striped”>caption Queue methods</caption<>thead><tr><td></td<>th scope=“col” style=“font-weight：normal; font-style：italic”>Throws exception</th<>scope=“col” style=“font-weight：normal; font-style：italic”>Returns special value</th<>/tr<>/thead<>tbody><tr<>th scope=“row”>Insert</th<>><td><#add(Object) add(e)/td><td/td><<#offer(Object) offer(e)>/tr th><><scope=“row”>Remove</th><td<#remove() remove()>/td<>#poll() poll()<> td/td></tr tr><<>th scope=“row”>Examine</th<>td#peek() peek()<>#element() element()><<>/td td/td<>/tr<>/tbody></table>

佇列通常但不一定以 FIFO（先出先出）的方式排序元素。例外狀況包括優先順序佇列，這些佇列會根據提供的比較子或元素的自然順序來排序元素，以及排序元素 LIFO 的 LIFO 佇列（或堆棧），以排序元素 LIFO（最後先出）。無論使用何種順序， <佇列的 em>head</em> 就是呼叫 #remove() 或 #poll()會移除的元素。在 FIFO 佇列中，所有新元素都會插入佇列 <的 em>tail</em> 。其他類型的佇列可能會使用不同的放置規則。每個 Queue 實作都必須指定其排序屬性。

#offer offer方法會盡可能插入項目，否則傳false回。這與 java.util.Collection#add Collection.add 方法不同，此方法只能藉由擲回未核取的例外狀況來新增元素。當 offer 失敗是正常，而不是例外的發生時，方法的設計目的是在固定容量中（或 ”bounded“）佇列。

#remove()和 #poll() 方法會移除並傳回佇列的前端。從佇列中移除的專案完全是佇列排序原則的函式，與實作與實作不同。和 remove() poll() 方法只有在佇列是空的時，其行為才不同： remove() 方法會擲回例外狀況，而 poll() 方法會傳 null回。

#element()和 #peek() 方法會傳回佇列的前端，但不要移除。

介面 Queue 不會定義 封鎖佇列方法，這在並行程序設計中很常見。這些方法會在介面中 java.util.concurrent.BlockingQueue 定義，這些方法會等候元素出現，或讓空間變成可用，而介面會擴充這個介面。

Queue 實作通常不允許插入 null 項目，雖然某些實作，例如 LinkedList，並不禁止插入 null。即使在允許它的實作中， null 也不應該插入， Queue如同 null 方法也用來做為特殊傳回值 poll ，以表示佇列不包含任何專案。

Queue 實作通常不會定義以項目為基礎的方法 equals 版本， hashCode 而是繼承類別 Object的識別型版本，因為元素型相等不一定對具有相同元素但不同排序屬性的佇列定義正確。

已在1.5中新增。

的 java.util.QueueJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

屬性

Handle	取得基礎 Android 物件的 JNI 值。 (繼承來源 IJavaObject)
IsEmpty	如果不包含 `Collection` 任何專案，則傳回。 (繼承來源 ICollection)
JniIdentityHashCode	傳回包裝實例的值 `java.lang.System.identityHashCode()` 。 (繼承來源 IJavaPeerable)
JniManagedPeerState	受控對等的狀態。 (繼承來源 IJavaPeerable)
JniPeerMembers	成員存取和調用支援。 (繼承來源 IJavaPeerable)
PeerReference	傳 JniObjectReference 回已包裝 Java 物件實例的。 (繼承來源 IJavaPeerable)

方法

Add(Object)	如果可以立即執行，而不違反容量限制，在成功時傳回，並在目前沒有可用空間時擲`IllegalStateException`回 `true` ，請將指定的專案插入此佇列中。
AddAll(ICollection)	將指定集合中的所有專案加入至這個集合（選擇性作業）。 (繼承來源 ICollection)
Clear()	從這個集合中移除所有專案（選擇性作業）。 (繼承來源 ICollection)
Contains(Object)	`true`如果這個集合包含指定的專案，則傳回。 (繼承來源 ICollection)
ContainsAll(ICollection)	`true`如果這個集合包含指定集合中的所有專案，則傳回。 (繼承來源 ICollection)
Disposed()	處置實例時呼叫。 (繼承來源 IJavaPeerable)
DisposeUnlessReferenced()	如果這個實例沒有未完成的參考，則呼叫 `Dispose()`，否則不會執行任何動作。 (繼承來源 IJavaPeerable)
Element()	擷取但不會移除此佇列的前端。
Equals(Object)	比較指定的對象與這個集合是否相等。 (繼承來源 ICollection)
Finalized()	實例完成時呼叫。 (繼承來源 IJavaPeerable)
ForEach(IConsumer)	針對的每個項目執行指定的動作，直到處理所有專案 `Iterable` 或動作擲回例外狀況為止。 (繼承來源 IIterable)
GetHashCode()	傳回這個集合的哈希碼值。 (繼承來源 ICollection)
Iterator()	傳回這個集合中元素的反覆運算器。 (繼承來源 ICollection)
Offer(Object)	如果可以立即這麼做，而不違反容量限制，請將指定的專案插入此佇列中。
Peek()	擷取，但不會移除此佇列的前端，如果這個佇列是空的，則傳回 `null` 。
Poll()	擷取並移除此佇列的前端，如果這個佇列是空的，則傳 `null` 回。
Remove()	擷取並移除此佇列的前端。
Remove(Object)	如果指定的專案存在，則從這個集合中移除指定專案的單一實例（選擇性作業）。 (繼承來源 ICollection)
RemoveAll(ICollection)	拿掉此集合的所有專案，這些元素也包含在指定的集合中（選擇性作業）。 (繼承來源 ICollection)
RemoveIf(IPredicate)	拿掉此集合中滿足指定述詞的所有專案。 (繼承來源 ICollection)
RetainAll(ICollection)	只保留這個集合中包含在指定集合中的專案（選擇性作業）。 (繼承來源 ICollection)
SetJniIdentityHashCode(Int32)	設定所 `JniIdentityHashCode`傳回的值。 (繼承來源 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	集合，其設計目的是在處理之前存放元素。 (繼承來源 IJavaPeerable)
SetPeerReference(JniObjectReference)	設定所 `PeerReference`傳回的值。 (繼承來源 IJavaPeerable)
Size()	傳回這個集合中的項目數目。 (繼承來源 ICollection)
Spliterator()	`Spliterator`透過這個 `Iterable`所描述的專案建立。 (繼承來源 IIterable)
ToArray()	傳回數位，其中包含這個集合中的所有專案。 (繼承來源 ICollection)
ToArray(IIntFunction)	傳回數位，其中包含這個集合中的所有專案，使用提供的 `generator` 函式來配置傳回的陣列。 (繼承來源 ICollection)
ToArray(Object[])	傳回數位，其中包含這個集合中的所有專案;傳回數位的運行時間類型是指定數位的運行時間類型。 (繼承來源 ICollection)
UnregisterFromRuntime()	取消註冊此實例，讓運行時間不會從未來的 Java.Interop.JniRuntime+JniValueManager.PeekValue 調用傳回它。 (繼承來源 IJavaPeerable)

明確介面實作

IIterable.Spliterator()

在 Spliterator 集合中的項目上建立。

(繼承來源 ICollection)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	集合，其設計目的是在處理之前存放元素。
GetJniTypeName(IJavaPeerable)	集合，其設計目的是在處理之前存放元素。
ToEnumerable(IIterable)	集合，其設計目的是在處理之前存放元素。
ToEnumerable<T>(IIterable)	集合，其設計目的是在處理之前存放元素。

適用於

共用方式為

IQueue 介面

定義

備註

屬性

方法

明確介面實作

擴充方法

適用於