IList Interface

Définition

[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

Dérivé

Java.Util.AbstractList

Java.Util.ArrayList

Java.Util.Concurrent.CopyOnWriteArrayList

Java.Util.LinkedList

Java.Util.Vector

Attributs

RegisterAttribute JavaTypeParametersAttribute

Implémente

IJavaObject IJavaPeerable IIterable ICollection ISequencedCollection IDisposable

Remarques

Collection ordonnée, où l’utilisateur a un contrôle précis sur l’emplacement dans la liste où chaque élément est inséré. L’utilisateur peut accéder aux éléments par son index entier (position dans la liste) et rechercher des éléments dans la liste.

Contrairement aux jeux, les listes autorisent généralement les éléments dupliqués. Plus formellement, les listes autorisent généralement des paires d’éléments e1 et e2 ainsi, e1.equals(e2)et elles autorisent généralement plusieurs éléments Null s’ils autorisent tous les éléments Null. Il n’est pas inconcevable que quelqu’un souhaite implémenter une liste qui interdit les doublons, en lisant des exceptions d’exécution lorsque l’utilisateur tente de les insérer, mais nous attendons que cette utilisation soit rare.

L’interface List place des dispositions supplémentaires, au-delà de celles spécifiées dans l’interface Collection , sur les contrats du iterator, add, remove, equalset hashCode des méthodes. Les déclarations d’autres méthodes héritées sont également incluses ici pour des raisons pratiques.

L’interface List fournit quatre méthodes pour l’accès positionnel (indexé) aux éléments de liste. Les listes (comme les tableaux Java) sont basées sur zéro. Notez que ces opérations peuvent s’exécuter dans le temps proportionnelle à la valeur d’index pour certaines implémentations (la LinkedList classe, par exemple). Par conséquent, l’itération sur les éléments d’une liste est généralement préférable à l’indexation par le biais de celle-ci si l’appelant ne connaît pas l’implémentation.

L’interface List fournit un itérateur spécial, appelé un ListIterator, qui permet l’insertion et le remplacement des éléments, et l’accès bidirectionnel en plus des opérations normales que l’interface Iterator fournit. Une méthode est fournie pour obtenir un itérateur de liste qui commence à une position spécifiée dans la liste.

L’interface List fournit deux méthodes pour rechercher un objet spécifié. Du point de vue des performances, ces méthodes doivent être utilisées avec précaution. Dans de nombreuses implémentations, ils effectuent des recherches linéaires coûteuses.

L’interface List fournit deux méthodes pour insérer et supprimer efficacement plusieurs éléments à un point arbitraire de la liste.

Remarque : Bien qu’il soit permis aux listes de se contenir en tant qu’éléments, la prudence extrême est conseillée : les equals méthodes ne hashCode sont plus bien définies sur une telle liste.

Certaines implémentations de liste 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 la liste 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">Listes< non modifiables/h2>

Les List#of(Object...) List.of méthodes de List#copyOf List.copyOf fabrique statique offrent un moyen pratique de créer des listes non modifiables. Les List 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, supprimés ou remplacés. L’appel d’une méthode mutator dans la liste entraîne UnsupportedOperationException toujours la levée. Toutefois, si les éléments contenus sont eux-mêmes mutables, cela peut entraîner la modification du contenu de la liste. <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>L’ordre des éléments de la liste est identique à l’ordre des arguments fournis ou des éléments du tableau fourni. <li>Les listes et leurs #subList(int, int) subList vues implémentent l’interface RandomAccess . <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>

Ajouté dans la version 1.2.

Documentation Java pour java.util.List.

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.