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)を許可し、通常、null 要素を許可する場合は複数の null 要素を許可します。 ユーザーが挿入しようとしたときにランタイム例外をスローすることで、重複を禁止するリストを誰かが実装することを望む可能性は考えられませんが、この使用はまれであると予想されます。

List インターフェイスは、Collection、iterator、add、remove、およびequalsメソッドのコントラクトに、hashCode インターフェイスで指定されているもの以外の追加の規定を配置します。 便宜上、他の継承メソッドの宣言もここに含まれています。

List インターフェイスには、リスト要素への位置指定 (インデックス付き) アクセスのための 4 つのメソッドが用意されています。 リスト (Java 配列など) は 0 から始まります。 これらの操作は、一部の実装 ( LinkedList クラスなど) のインデックス値に比例して時間内に実行される場合があることに注意してください。 したがって、呼び出し元が実装を知らない場合は、通常、リスト内の要素を反復処理することをお勧めします。

List インターフェイスは、ListIteratorと呼ばれる特別な反復子を提供します。これにより、要素の挿入と置換が可能になり、Iterator インターフェイスが提供する通常の操作に加えて双方向アクセスが可能になります。 リスト内の指定した位置から始まるリスト反復子を取得するメソッドが用意されています。

List インターフェイスには、指定したオブジェクトを検索する 2 つのメソッドが用意されています。 パフォーマンスの観点から、これらのメソッドは慎重に使用する必要があります。 多くの実装では、コストのかかる線形検索が実行されます。

List インターフェイスには、リスト内の任意のポイントで複数の要素を効率的に挿入および削除するための 2 つのメソッドが用意されています。

注: リスト自体を要素として含めることもできますが、 equals メソッドと hashCode メソッドは、このようなリストで明確に定義されなくなりました。

一部のリスト実装には、含まれる要素に制限があります。 たとえば、一部の実装では null 要素が禁止され、一部の実装では要素の型に制限があります。 不適格な要素を追加しようとすると、通常は NullPointerException または ClassCastException、チェックされていない例外がスローされます。 不適格な要素の存在を照会しようとすると、例外がスローされるか、単に false が返される可能性があります。一部の実装は以前の動作を示し、一部は後者を示します。 より一般的には、不適格な要素に対する操作を試みると、リストに不適格な要素が挿入されない場合、実装のオプションで例外がスローされたり、成功したりする可能性があります。 このような例外は、このインターフェイスの仕様では "省略可能" としてマークされます。

<h2>"変更不可">変更不可リスト</h2>

List#of(Object...) List.ofおよびList#copyOf List.copyOf静的ファクトリ メソッドは、変更できないリストを作成する便利な方法を提供します。 これらのメソッドによって作成される List インスタンスには、次の特性があります。

<ul><li><>変更できません</i>。 要素を追加、削除、または置き換えることはできません。 List でミューテーター メソッドを呼び出すと、常に UnsupportedOperationException がスローされます。 ただし、含まれている要素自体が変更可能な場合は、リストの内容が変わる可能性があります。 <li>要素 null 禁止します。 null要素を使用して作成しようとすると、NullPointerExceptionになります。 <li>すべての要素がシリアル化可能な場合はシリアル化可能です。 <li>リスト内の要素の順序は、指定された引数の順序、または指定された配列内の要素の順序と同じです。 <li>リストとその #subList(int, int) subList ビューは、 RandomAccess インターフェイスを実装します。 <li>値に基づいています。 プログラマは、#equals(Object) と等しいインスタンスを交換可能として扱い、同期に使用しないでください。または、予期しない動作が発生する可能性があります。 たとえば、将来のリリースでは、同期が失敗する可能性があります。 呼び出し元は、返されるインスタンスの ID に関する想定を行う必要はありません。 ファクトリは、新しいインスタンスを自由に作成したり、既存のインスタンスを再利用したりできます。 <li>Y は、 Serialized Form ページで指定されたとおりにシリアル化されます。 </ul>

1.2 で追加されました。

java.util.Listの Java ドキュメント。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。