ISet インターフェイス

定義

[Android.Runtime.Register("java/util/Set", "", "Java.Util.ISetInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface ISet : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ICollection

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

派生

Android.Util.ArraySet

Java.Util.AbstractSet

Java.Util.HashSet

Java.Util.INavigableSet

Java.Util.ISequencedSet

その他…

属性

RegisterAttribute JavaTypeParametersAttribute

実装

IJavaObject IJavaPeerable IIterable ICollection IDisposable

注釈

重複する要素を含まないコレクション。 より正式には、セットには、e1、最大で 1 つの null 要素など、e2要素とe1.equals(e2)のペアが含まれています。 名前からわかるように、このインターフェイスは数学的 セット の抽象化をモデル化します。

Set インターフェイスは、Collection インターフェイスから継承されたもの以外にも、すべてのコンストラクターのコントラクトと、add、equals、およびhashCodeメソッドのコントラクトに追加の規定を配置します。 便宜上、他の継承メソッドの宣言もここに含まれています。 (これらの宣言に付随する仕様は、 Set インターフェイスに合わせて調整されていますが、追加の規定は含まれていません)。

コンストラクターに関する追加の規定は、(上で定義したように) すべてのコンストラクターが重複する要素を含まないセットを作成する必要があるということです。

注: 変更可能なオブジェクトがセット要素として使用される場合は、細心の注意を払う必要があります。 オブジェクトがセット内の要素である間に、 equals 比較に影響する方法でオブジェクトの値が変更された場合、セットの動作は指定されません。 この禁止の特別なケースは、セットがそれ自体を要素として含むのは許可されないことです。

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

<h2>"unmodifiable">Unmodifiable Sets</h2>

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

<ul><li><>変更できません</i>。 要素を追加または削除することはできません。 Set でミューテーター メソッドを呼び出すと、常に UnsupportedOperationException がスローされます。 ただし、含まれている要素自体が変更可能な場合は、Set の動作に一貫性がない場合や、その内容が変わる可能性があります。 <li>要素 null 禁止します。 null要素を使用して作成しようとすると、NullPointerExceptionになります。 <li>すべての要素がシリアル化可能な場合はシリアル化可能です。 <li>作成時に重複する要素を拒否します。 静的ファクトリ メソッドに渡された要素が重複すると、 IllegalArgumentException。 <li>セット要素の反復順序は指定されておらず、変更される可能性があります。 <li>値に基づいています。 プログラマは、#equals(Object) と等しいインスタンスを交換可能として扱い、同期に使用しないでください。または、予期しない動作が発生する可能性があります。 たとえば、将来のリリースでは、同期が失敗する可能性があります。 呼び出し元は、返されるインスタンスの ID に関する想定を行う必要はありません。 ファクトリは、新しいインスタンスを自由に作成したり、既存のインスタンスを再利用したりできます。 <li>シリアル化フォーム ページで指定されたとおりに シリアル化されます 。 </ul>

このインターフェイスは、Java コレクション フレームワークのメンバーです。

1.2 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。