IList 介面

定義

[Android.Runtime.Register("java/util/List", "", "Java.Util.IListInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface IList : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISequencedCollection

[<Android.Runtime.Register("java/util/List", "", "Java.Util.IListInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type IList = interface
    interface ICollection
    interface IIterable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISequencedCollection

衍生

Java.Util.AbstractList

Java.Util.ArrayList

Java.Util.Concurrent.CopyOnWriteArrayList

Java.Util.LinkedList

Java.Util.Vector

屬性

RegisterAttribute JavaTypeParametersAttribute

實作

IJavaObject IJavaPeerable IIterable ICollection ISequencedCollection IDisposable

備註

一個有序集合，使用者能精確控制每個元素在列表中的位置。 使用者可以依照整數索引（在列表中的位置）存取元素，並在列表中搜尋元素。

與集合不同，列表通常允許重複元素。 更正式地說，列表通常允許元素對 e1 和 e2 ，使得 e1.equals(e2)，且如果允許空元素，通常允許多個空元素。 有人可能會想實作一個清單，透過執行時例外來阻止重複，當使用者嘗試插入時拋出例外，但我們預期這種使用會很少見。

介面在 List 、 Collection、 iterator、 add和 remove 方法的契約上，除了介面中equals指定的規定外，還會hashCode附加其他條件。 為了方便起見，這裡也包含了其他繼承方法的宣告。

介面 List 提供四種位置（索引）存取清單元素的方法。 串列（像 Java 陣列）是以零為基礎的。 請注意，這些操作在某些實作 LinkedList （例如類別）中，執行時間可能與索引值成正比。 因此，若呼叫者不熟悉實作，通常比透過清單索引更可取。

介面 List 提供一個特殊的迭代器，稱為 ListIterator，除了介面正常操作外，還能進行元素插入與替換，以及雙向存取 Iterator 。 提供一種方法，可取得從指定位置開始的列表迭代器。

介面 List 提供兩種方法來搜尋指定物件。 從性能角度來看，這些方法應謹慎使用。 在許多實作中，它們會執行昂貴的線性搜尋。

介面 List 提供兩種方法，能有效地在清單中的任意點插入與移除多個元素。

注意：雖然列表可以將自己包含為元素，但建議極度謹慎： equals 與 hashCode 方法已不再明確定義於此類清單中。

部分清單實作對其可包含的元素有限制。 例如，有些實作禁止空元素，有些則對元素的類型有限制。 嘗試加入不合格元素會拋出未檢查的例外，通常是 NullPointerException 或 ClassCastException。 嘗試查詢不合格元素的存在可能會拋出例外，或直接回傳 false;有些實作會呈現前者，有些則會呈現後者。 更一般來說，嘗試對不合格元素進行操作，但其完成後不會讓該不合格元素插入清單，可能會拋出例外，也可能成功，這取決於實作的選擇。 此類例外在此介面規範中標示為「可選」。

<h2>“不可修改”不可修改列表>/<h2>

List#of(Object...) List.of靜List#copyOf List.copyOf態工廠方法提供了一種方便的方式來建立不可修改的清單。 這些方法所建立的 List 實例具有以下特性：

<ul><li>他們是<>不可修改/不可<更改>的。 元素無法新增、移除或替換。 呼叫清單上的任何變異器方法都會被 UnsupportedOperationException 拋出。 然而，如果所包含的元素本身是可變的，這可能會導致清單的內容看起來會改變。 <李>：他們不允許 null 元素。 嘗試用 null 元素創建它們會得到 NullPointerException。 <李>如果所有元素都可以序列化，則它們是可序列化的。 <li>列表中元素的順序與所提供參數的順序，或是所給陣列中元素的順序相同。 <li>清單及其#subList(int, int) subList檢視實作了介面。RandomAccess <李>：它們是以價值為基礎的。 程式設計師應將 #equals（物件）相等的實例視為可互換，不應用於同步，否則可能會產生不可預測的行為。 例如，在未來版本中，同步可能會失敗。 呼叫者不應對回傳實例的身份做出任何假設。 工廠可以自由建立新實例或重用現有實例。 <li>它們依照序 號表單 頁面所指定的序列化。 </ul>

在 1.2 版本中加入。

的 java.util.ListJava 檔。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。