Vector 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
這個 Vector 類別實作了一個可成長的物件陣列。
[Android.Runtime.Register("java/util/Vector", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public class Vector : Java.Util.AbstractList, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Util.IRandomAccess
[<Android.Runtime.Register("java/util/Vector", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type Vector = class
inherit AbstractList
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ICloneable
interface IList
interface ICollection
interface IIterable
interface ISequencedCollection
interface IRandomAccess
- 繼承
- 衍生
- 屬性
- 實作
備註
這個 Vector 類別實作了一個可成長的物件陣列。 與陣列類似,它包含可透過整數索引存取的元件。 不過,A Vector 的尺寸可以根據需要調整,以配合新增或移除物品 Vector 。
每個向量嘗試透過維護 a capacity 和 capacityIncrement來優化儲存管理。 通常 的 capacity 大小至少與向量大小相同;通常之所以較大,是因為隨著分量加入向量,向量的儲存會以大小為 capacityIncrement的區塊增加。 應用程式可以在插入大量元件前先增加向量容量;這減少了增量重新配置的量。
此類別 #iterator() iterator 與 #listIterator(int) listIterator 方法回傳的迭代器為 <em>fail-fast</em>:若向量在迭代器建立後的任何時間被結構性修改,且非透過迭代器自身 ListIterator#remove() remove 或 ListIterator#add(Object) add 方法,迭代器將拋出 ConcurrentModificationException。 因此,面對並行修改時,迭代器能迅速且乾淨地失敗,而非冒著未來某個未知時間出現任意且非確定性行為的風險。 該方法回傳的Enumeration Enumerations結果為 #elements() elementsem<not>/em< fail-fast;若在列舉建立後任何時間對向量結構進行結構修改,則列舉結果未定義。>
請注意,迭代器的失效快速行為無法保證,因為一般而言,在存在非同步的並行修改時,無法做出任何硬性保證。 失效快速迭代器則是以盡力而為的方式投擲 ConcurrentModificationException 。 因此,撰寫依賴此例外來確保正確性的程式是錯誤的: 迭代器的快速失效行為應該只用來偵測錯誤。
自 Java 2 平台 v1.2 起,此類別被後改以實作介面List,成為 Java 集合框架的成員。 與新的集合實作不同, Vector 它是同步的。 若不需要執行緒安全實作,建議以 ArrayListVector取代 。
1.0 版本新增。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| 名稱 | Description |
|---|---|
| Vector() |
構造一個空向量,使其內部資料陣列大小為 |
| Vector(ICollection) |
構造一個包含指定集合元素的向量,依照集合的迭代器回傳的順序排列。 |
| Vector(Int32, Int32) |
構造一個具有指定初始容量與容量增量的空向量。 |
| Vector(Int32) |
構造一個空向量,其初始容量為指定,且其容量增量為零。 |
| Vector(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
| 名稱 | Description |
|---|---|
| CapacityIncrement |
當向量大小大於容量時,容量自動增加的量。 |
| Class |
回傳此 |
| ElementCount |
這個 |
| ElementData |
儲存向量分量的陣列緩衝區。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsEmpty |
待補充 (繼承來源 AbstractCollection) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
這個 |
| JniPeerMembers |
這個 |
| ModCount |
這份名單結構性 被修改的次數。 (繼承來源 AbstractList) |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
| ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
方法
| 名稱 | Description |
|---|---|
| Add(Int32, Object) |
待補充 (繼承來源 AbstractList) |
| Add(Object) |
待補充 (繼承來源 AbstractCollection) |
| AddAll(ICollection) |
待補充 (繼承來源 AbstractCollection) |
| AddAll(Int32, ICollection) |
待補充 (繼承來源 AbstractList) |
| AddElement(Object) |
將指定的分量加到向量末端,並將大小增加一。 |
| Capacity() |
回傳該向量的當前容量。 |
| Clear() |
待補充 (繼承來源 AbstractCollection) |
| Clone() |
回傳這個向量的克隆。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
這個 |
| Contains(Object) |
待補充 (繼承來源 AbstractCollection) |
| ContainsAll(ICollection) |
待補充 (繼承來源 AbstractCollection) |
| CopyInto(Object[]) |
將該向量的分量複製到指定的陣列中。 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
這個 |
| ElementAt(Int32) |
回傳指定索引的元件。 |
| Elements() |
回傳該向量分量的枚舉。 |
| EnsureCapacity(Int32) |
必要時增加該向量的容量,以確保它至少能容納最小容量參數所指定的分量數量。 |
| Equals(Object) |
這個 |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| FirstElement() |
回傳該向量的第一個分量(索引項目 |
| ForEach(IConsumer) |
這個 |
| Get(Int32) |
回傳該向量中指定位置的元素。 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| IndexOf(Object, Int32) |
回傳該向量中指定元素首次出現的索引,從 向前搜尋, |
| IndexOf(Object) |
待補充 (繼承來源 AbstractList) |
| InsertElementAt(Object, Int32) |
將指定物件作為該向量的分量插入於指定的 |
| Iterator() |
回傳一個按正確順序處理此列表中元素的迭代器。 (繼承來源 AbstractList) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| LastElement() |
回傳向量的最後一個分量。 |
| LastIndexOf(Object, Int32) |
回傳該向量中指定元素最後出現的索引,從 回溯 |
| LastIndexOf(Object) |
待補充 (繼承來源 AbstractList) |
| ListIterator() |
待補充 (繼承來源 AbstractList) |
| ListIterator(Int32) |
待補充 (繼承來源 AbstractList) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Remove(Int32) |
待補充 (繼承來源 AbstractList) |
| Remove(Object) |
待補充 (繼承來源 AbstractCollection) |
| RemoveAll(ICollection) |
待補充 (繼承來源 AbstractCollection) |
| RemoveAllElements() |
移除該向量的所有分量,並將其大小設為零。 |
| RemoveElement(Object) |
移除該參數從此向量中首次(索引最低)的出現點。 |
| RemoveElementAt(Int32) |
刪除指定索引處的元件。 |
| RemoveIf(IPredicate) |
這個 |
| RemoveRange(Int32, Int32) |
從此列表中移除所有介於 |
| ReplaceAll(IUnaryOperator) |
這個 |
| RetainAll(ICollection) |
待補充 (繼承來源 AbstractCollection) |
| Set(Int32, Object) |
待補充 (繼承來源 AbstractList) |
| SetElementAt(Object, Int32) |
將該向量指定 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
這個 |
| SetSize(Int32) |
設定這個向量的大小。 |
| Size() |
回傳此向量中的分量數量。 |
| Sort(IComparator) |
這個 |
| Spliterator() |
在這個列表中的元素上建立 <em late-binding>/em<>和 em<fail-fast>/em<>。 |
| SubList(Int32, Int32) |
待補充 (繼承來源 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 |
這個 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
這個 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
這個 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
這個 |
| IJavaPeerable.UnregisterFromRuntime() |
這個 |
擴充方法
| 名稱 | 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) |
試著強制 |