HashSet 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
這個類別會實作 Set
哈希表支援的介面(實際上為 HashMap
實例)。
[Android.Runtime.Register("java/util/HashSet", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class HashSet : Java.Util.AbstractSet, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICloneable
[<Android.Runtime.Register("java/util/HashSet", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type HashSet = class
inherit AbstractSet
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICloneable
interface ISet
interface ICollection
interface IIterable
- 繼承
- 衍生
- 屬性
- 實作
備註
這個類別會實作 Set
哈希表支援的介面(實際上為 HashMap
實例)。 它不保證集合的反覆運算順序;特別是,它不保證訂單在一段時間內會維持不變。 這個類別允許專案 null
。
這個類別會提供基本作業 (add
、 remove
contains
和 size
) 的常數時間效能,假設哈希函式會適當地分散值區之間的專案。 逐一查看此集合需要時間與實例大小的總和 HashSet
(元素數目)加上備份 HashMap
實例的「容量」(貯體數目)成正比。 因此,如果反覆專案效能很重要,請務必不要將初始容量設定為太高(或負載因數太低)。
<強>請注意,此實作不會同步處理。</strong> 如果多個線程同時存取哈希集,而且至少有一個線程修改集合, 則必須 在外部同步處理。 這通常是透過同步處理自然封裝集合的某些物件來完成。
如果不存在這類物件,則集合應該使用 Collections#synchronizedSet Collections.synchronizedSet
方法「包裝」。 這最好是在建立時完成,以避免意外對集合進行未同步存取:
Set s = Collections.synchronizedSet(new HashSet(...));
這個類別的 方法所傳回的 iterator
反覆運算器是 失敗的:如果在建立反覆運算器之後隨時修改集合,除了透過反覆運算器自己的 remove
方法之外,Iterator 會擲回 ConcurrentModificationException
。 因此,面對並行修改,反覆運算器會快速且乾淨地失敗,而不是在未來不確定的時間冒著任意、不具決定性的行為的風險。
請注意,Iterator 的失敗快速行為無法保證,一般來說,不可能在未同步處理並行修改的情況下進行任何硬式保證。 快速反覆運算器會盡最大努力擲回 ConcurrentModificationException
。 因此,撰寫依賴此例外狀況的程序正確性是錯誤的: Iterator 的失敗快速行為應該只用來偵測 Bug。
這個類別是 Java Collections Framework 的成員。
已在1.2中新增。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
HashSet() |
建構新的空白集合;備份 |
HashSet(ICollection) |
建構新的集合,其中包含指定集合中的專案。 |
HashSet(Int32) |
建構新的空白集合;備份 |
HashSet(Int32, Single) |
建構新的空白集合;備份 |
HashSet(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
Class |
傳回這個 |
Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
IsEmpty |
要新增 (繼承來源 AbstractCollection) |
JniIdentityHashCode |
這個類別會實作 |
JniPeerMembers |
這個類別會實作 |
PeerReference |
這個類別會實作 |
ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
方法
Add(Object) |
要新增 (繼承來源 AbstractCollection) |
AddAll(ICollection) |
要新增 (繼承來源 AbstractCollection) |
Clear() |
要新增 (繼承來源 AbstractCollection) |
Clone() |
傳回這個 |
Contains(Object) |
要新增 (繼承來源 AbstractCollection) |
ContainsAll(ICollection) |
要新增 (繼承來源 AbstractCollection) |
Dispose() |
這個類別會實作 |
Dispose(Boolean) |
這個類別會實作 |
Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
Iterator() |
傳回此集合中元素的反覆運算器。 |
JavaFinalize() |
當垃圾收集決定不再參考物件時,垃圾收集行程在 物件上呼叫。 (繼承來源 Object) |
Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
Remove(Object) |
要新增 (繼承來源 AbstractCollection) |
RemoveAll(ICollection) |
要新增 (繼承來源 AbstractCollection) |
RetainAll(ICollection) |
要新增 (繼承來源 AbstractCollection) |
SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
Size() |
傳回這個集合中的項目數(其基數)。 |
Spliterator() |
建立 <em late-binding</em> 和 <em>在這個集合中的元素上失敗 fast</em |
ToArray() |
要新增 (繼承來源 AbstractCollection) |
ToArray(Object[]) |
要新增 (繼承來源 AbstractCollection) |
ToArray<T>() |
這個類別會實作 |
ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
UnregisterFromRuntime() |
這個類別會實作 |
Wait() |
讓目前線程等候直到喚醒為止,通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object) |
Wait(Int64) |
讓目前的線程等到喚醒為止,通常是因為 <em>notified</em> 或 <em>interrupted</em>,或直到經過一定數量的實時為止。 (繼承來源 Object) |
Wait(Int64, Int32) |
讓目前的線程等到喚醒為止,通常是因為 <em>notified</em> 或 <em>interrupted</em>,或直到經過一定數量的實時為止。 (繼承來源 Object) |
明確介面實作
IJavaPeerable.Disposed() |
這個類別會實作 |
IJavaPeerable.DisposeUnlessReferenced() |
這個類別會實作 |
IJavaPeerable.Finalized() |
這個類別會實作 |
IJavaPeerable.JniManagedPeerState |
這個類別會實作 |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
這個類別會實作 |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
這個類別會實作 |
IJavaPeerable.SetPeerReference(JniObjectReference) |
這個類別會實作 |
擴充方法
JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
JavaCast<TResult>(IJavaObject) |
這個類別會實作 |
GetJniTypeName(IJavaPeerable) |
這個類別會實作 |
ToEnumerable(IIterable) |
這個類別會實作 |
ToEnumerable<T>(IIterable) |
這個類別會實作 |