ArrayList 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
介面的可調整陣列實作 List 。
[Android.Runtime.Register("java/util/ArrayList", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class ArrayList : Java.Util.AbstractList, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Util.IRandomAccess
[<Android.Runtime.Register("java/util/ArrayList", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type ArrayList = class
inherit AbstractList
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICloneable
interface IList
interface ICollection
interface IIterable
interface ISequencedCollection
interface IRandomAccess
- 繼承
- 屬性
- 實作
備註
介面的可調整陣列實作 List 。 實作所有可選的列表操作,並允許所有元素,包括 null。 除了實作介面外 List ,這個類別還提供操作內部用來儲存清單陣列大小的方法。 (此類大致等價 Vector於 ,但不同步。)
size這些 、 isEmpty、 get、 setiteratorlistIterator 、 和 操作都是常數時間執行的。 此 add 操作以 攤還常數時間運行,也就是說,加入 n 個元素需要 O(n) 時間。 其他所有運算大致以線性時間進行。 與實作相比 LinkedList ,常數因子較低。
每個 ArrayList 實例都有 一個容量。 容量是用來儲存清單中元素的陣列大小。 它總是至少和清單大小一樣大。 隨著元素加入 ArrayList,其容量會自動增加。 成長政策的細節未具體說明,僅說明新增元素的攤還時間成本為固定不變。
應用程式可以在使用ArrayList操作加入大量元素前,先增加實例的容量ensureCapacity。 這可能減少增量重新分配的幅度。
<強>請注意,此實作並非同步。</強> 如果多個執行緒同時存取一個 ArrayList 實例,且至少有一個執行緒結構性修改了清單, 則必須 在外部同步。 (結構修改是指任何新增或刪除一個或多個元素,或明確調整支撐陣列大小的操作;僅僅設定元素的值並不構成結構性修改。)這通常是透過在某個自然封裝該清單的物件上同步來達成。
若不存在此類物件,則應使用該 Collections#synchronizedList Collections.synchronizedList 方法「包裝」該清單。 這最好在建立時進行,以避免意外不同步地存取清單:
List list = Collections.synchronizedList(new ArrayList(...));
此類別 #iterator() iterator 與 #listIterator(int) listIterator 方法回傳的迭代器為 <em>fail-fast</em>:若在迭代器建立後的任何時間對列表進行結構性修改,且非透過迭代器自身 ListIterator#remove() remove 或 ListIterator#add(Object) add 方法,迭代器將拋出 ConcurrentModificationException。 因此,面對並行修改時,迭代器能迅速且乾淨地失敗,而非冒著未來某個未知時間出現任意且非確定性行為的風險。
請注意,迭代器的失效快速行為無法保證,因為一般而言,在存在非同步的並行修改時,無法做出任何硬性保證。 失效快速迭代器則是以盡力而為的方式投擲 ConcurrentModificationException 。 因此,撰寫依賴此例外來確保正確性的程式是錯誤的: 迭代器的快速失效行為應該只用來偵測錯誤。
此類別是 Java 集合框架的成員。
在 1.2 版本中加入。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| ArrayList() |
構建一個初始容量為十的空清單。 |
| ArrayList(ICollection) |
構造一個包含指定集合元素的清單,依照集合迭代器回傳的順序排列。 |
| ArrayList(Int32) |
構造一個具有指定初始容量的空清單。 |
| ArrayList(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| First |
取得這個集合的第一個元素。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsEmpty |
若此集合不包含任何元素,則回傳為真。 (繼承來源 AbstractCollection) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
取得用於存取此 Java 綁定成員的 JNI 元資料。 |
| Last |
拿到這個合集的最後一個元素。 |
| ModCount |
這份名單結構性 被修改的次數。 (繼承來源 AbstractList) |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| Add(Int32, Object) |
在此清單中插入指定元素於指定位置(可選操作)。 (繼承來源 AbstractList) |
| Add(Object) |
確保此集合包含指定的元素(可選操作)。 (繼承來源 AbstractCollection) |
| AddAll(ICollection) |
將指定集合中的所有元素加入此集合(可選操作)。 (繼承來源 AbstractCollection) |
| AddAll(Int32, ICollection) |
將指定集合中的所有元素插入此清單中指定的位置(可選操作)。 (繼承來源 AbstractList) |
| AddFirst(Object) |
新增一個元素作為此集合的第一個元素(可選操作)。 |
| AddLast(Object) |
將元素加入為此集合的最後一個元素(可選操作)。 |
| Clear() |
移除此集合中的所有元素(可選操作)。 (繼承來源 AbstractCollection) |
| Clone() |
回傳這個 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
將此對等節點的建置委派給執行時的值管理器。 (繼承來源 JavaObject) |
| Contains(Object) |
若此集合包含指定元素,則回傳為真。 (繼承來源 AbstractCollection) |
| ContainsAll(ICollection) |
若此集合包含指定集合中的所有元素,則回傳為真。 (繼承來源 AbstractCollection) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
請求值管理器處置此對等節點,除非其映射保留該受管理實例。 (繼承來源 JavaObject) |
| EnsureCapacity(Int32) |
必要時增加此 |
| Equals(Object) |
測試另一個受管理節點是否參考相同的 Java 物件。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| ForEach(IConsumer) |
對可迭代的每個元素執行指定動作,直到所有元素處理完畢或動作拋出例外為止。 |
| Get(Int32) |
回傳該列表中指定位置的元素。 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| IndexOf(Object) |
回傳該清單中該元素首次出現的索引,若列表中未包含該元素則回傳 -1。 (繼承來源 AbstractList) |
| Iterator() |
回傳一個按正確順序處理此列表中元素的迭代器。 (繼承來源 AbstractList) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| LastIndexOf(Object) |
回傳該列表中指定元素最後出現的索引,若列表中未包含該元素則回傳 -1。 (繼承來源 AbstractList) |
| ListIterator() |
回傳對該清單中元素的列表迭代器(依正確順序)。 (繼承來源 AbstractList) |
| ListIterator(Int32) |
回傳一個列表迭代器,從列表中指定的位置開始,對該列表中的元素(依正確順序)進行。 (繼承來源 AbstractList) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Remove(Int32) |
移除該清單中指定位置的元素(可選操作)。 (繼承來源 AbstractList) |
| Remove(Object) |
若該集合存在,則移除該集合中單一的實例(可選操作)。 (繼承來源 AbstractCollection) |
| RemoveAll(ICollection) |
移除該集合中所有同時包含於指定集合中的元素(可選操作)。 (繼承來源 AbstractCollection) |
| RemoveFirst() |
移除並回傳此集合的第一個元素(可選操作)。 |
| RemoveIf(IPredicate) |
移除該集合中所有滿足該謂詞的元素。 |
| RemoveLast() |
移除並回傳此集合的最後一個元素(可選操作)。 |
| RemoveRange(Int32, Int32) |
從此列表中移除所有介於 |
| ReplaceAll(IUnaryOperator) |
更新每個元素,並根據指定操作的結果進行更新。 |
| RetainAll(ICollection) |
只保留該集合中包含於指定集合中的元素(可選操作)。 (繼承來源 AbstractCollection) |
| Set(Int32, Object) |
將此列表中指定位置的元素替換為指定元素(可選操作)。 (繼承來源 AbstractList) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在控制區塊中儲存參考值,但不建立 JNI 參考副本。 (繼承來源 JavaObject) |
| Size() |
傳回此清單中的項目數目。 |
| Sort(IComparator) |
用指定的比較器對此列表的元素進行排序。 |
| Spliterator() |
在這個列表中的元素上建立 <em late-binding>/em<>和 em<fail-fast>/em<>。 |
| SubList(Int32, Int32) |
回傳該清單中指定 fromIndex 包含與 toIndex 排他之間的部分視圖。 (繼承來源 AbstractList) |
| ToArray() |
回傳包含此集合中所有元素的陣列。 (繼承來源 AbstractCollection) |
| ToArray(Object[]) |
回傳包含此集合中所有元素的陣列;回傳陣列的執行時型別即為指定陣列的類型。 (繼承來源 AbstractCollection) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| TrimToSize() |
將此 |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒,通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒,通常是透過 <em>通知</><em 或 em>中斷</em>,或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| ToEnumerable(IIterable) |
回傳 和 IEnumerable ,會對 Java IIterable進行迭代,允許 |
| ToEnumerable<T>(IIterable) |
回傳 和 IEnumerable<T> ,該 在 Java IIterable上迭代,將每個元素 集結為 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |