ISet Interface

Définition

[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

Dérivé

Android.Util.ArraySet

Java.Util.AbstractSet

Java.Util.HashSet

Java.Util.INavigableSet

Java.Util.ISequencedSet

Plus…

Attributs

RegisterAttribute JavaTypeParametersAttribute

Implémente

IJavaObject IJavaPeerable IIterable ICollection IDisposable

Remarques

Collection qui ne contient aucun élément en double. Plus formellement, les jeux ne contiennent aucune paire d’éléments e1 et e2 ainsi e1.equals(e2), et au plus un élément Null. Comme indiqué par son nom, cette interface modélise l’abstraction de jeu mathématique.

L’interface Set place des dispositions supplémentaires, au-delà de celles héritées de l’interfaceCollection, sur les contrats de tous les constructeurs et sur les contrats des addequals méthodes et hashCode des méthodes. Les déclarations d’autres méthodes héritées sont également incluses ici pour des raisons pratiques. (Les spécifications qui accompagnent ces déclarations ont été adaptées à l’interface Set , mais elles ne contiennent aucune disposition supplémentaire.)

La disposition supplémentaire sur les constructeurs n’est pas surprenant que tous les constructeurs doivent créer un jeu qui ne contient aucun élément en double (tel que défini ci-dessus).

Remarque : Un grand soin doit être exercé si des objets mutables sont utilisés comme éléments définis. Le comportement d’un jeu n’est pas spécifié si la valeur d’un objet est modifiée d’une manière qui affecte les comparaisons equals pendant que l’objet est un élément dans l’ensemble. Un cas particulier de cette interdiction est qu’il n’est pas permis à un ensemble de se contenir en tant qu’élément.

Certaines implémentations de jeu ont des restrictions sur les éléments qu’ils peuvent contenir. Par exemple, certaines implémentations interdisent les éléments Null et certaines ont des restrictions sur les types de leurs éléments. La tentative d’ajout d’un élément inéligible lève une exception non cochée, généralement NullPointerException ou ClassCastException. La tentative d’interrogation de la présence d’un élément inéligible peut lever une exception, ou elle peut simplement retourner false ; certaines implémentations présenteront l’ancien comportement et certaines présenteront cette dernière. Plus généralement, la tentative d’une opération sur un élément inéligible dont l’achèvement n’entraînerait pas l’insertion d’un élément inéligible dans l’ensemble peut lever une exception ou réussir, à l’option de l’implémentation. Ces exceptions sont marquées comme « facultatives » dans la spécification de cette interface.

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

Les Set#of(Object...) Set.of méthodes de Set#copyOf Set.copyOf fabrique statique offrent un moyen pratique de créer des ensembles non modifiables. Les Set instances créées par ces méthodes ont les caractéristiques suivantes :

<ul>li Ils sont <inmodifiables<>/i>.>< Les éléments ne peuvent pas être ajoutés ou supprimés. L’appel d’une méthode mutator sur set entraîne UnsupportedOperationException toujours la levée. Toutefois, si les éléments contenus sont eux-mêmes mutables, cela peut entraîner le comportement incohérent de l’ensemble ou de son contenu à changer. <li>Ils interdisent null les éléments. Tente de les créer avec null des éléments résultant.NullPointerException <li>Ils sont sérialisables si tous les éléments sont sérialisables. <li>Ils rejettent les éléments dupliqués au moment de la création. Les éléments dupliqués passés à une méthode de fabrique statique aboutissent à IllegalArgumentException. <li>L’ordre d’itération des éléments set n’est pas spécifié et est susceptible de changer. <li>Elles sont basées sur des valeurs. Les programmeurs doivent traiter les instances qui sont #equals(Object) égales comme interchangeables et ne doivent pas les utiliser pour la synchronisation ou un comportement imprévisible peut se produire. Par exemple, dans une version ultérieure, la synchronisation peut échouer. Les appelants ne doivent pas faire d’hypothèses sur l’identité des instances retournées. Les fabriques sont libres de créer de nouvelles instances ou de réutiliser des instances existantes. <li>Ils sont sérialisés comme spécifié dans la page Formulaire sérialisé . </ul>

Cette interface est membre de l’infrastructure Java Collections.

Ajouté dans la version 1.2.

Documentation Java pour java.util.Set.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.