IList Interface

Definição

[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.ICollection

[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

[<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

Derivado

Java.Util.AbstractList

Java.Util.ArrayList

Java.Util.Concurrent.CopyOnWriteArrayList

Java.Util.LinkedList

Java.Util.Vector

Atributos

RegisterAttribute JavaTypeParametersAttribute

Implementações

IJavaObject IJavaPeerable IIterable ICollection IDisposable ISequencedCollection

Comentários

Uma coleção ordenada, em que o usuário tem controle preciso sobre onde na lista cada elemento é inserido. O usuário pode acessar elementos por seu índice inteiro (posição na lista) e pesquisar elementos na lista.

Ao contrário dos conjuntos, as listas normalmente permitem elementos duplicados. Mais formalmente, as listas normalmente permitem pares de elementos e1 e e2 tal que e1.equals(e2), e normalmente permitem vários elementos nulos se permitirem elementos nulos. Não é inconcebível que alguém deseje implementar uma lista que proíba duplicatas, lançando exceções de tempo de execução quando o usuário tenta inseri-las, mas esperamos que esse uso seja raro.

A List interface coloca estipulações adicionais, além daquelas Collection especificadas na interface, nos contratos dos iteratormétodos , add, remove, equals, e hashCode . Declarações para outros métodos herdados também são incluídas aqui por conveniência.

A List interface fornece quatro métodos para acesso posicional (indexado) aos elementos da lista. Listas (como arrays Java) são baseadas em zero. Observe que essas operações podem ser executadas em tempo proporcional ao valor do índice para algumas implementações (a LinkedList classe, por exemplo). Portanto, iterar sobre os elementos em uma lista normalmente é preferível à indexação por meio dela se o chamador não souber a implementação.

A List interface fornece um iterador especial, chamado , que permite a inserção e substituição de ListIteratorelementos e acesso bidirecional, além das operações normais que a Iterator interface fornece. Um método é fornecido para obter um iterador de lista que começa em uma posição especificada na lista.

A List interface fornece dois métodos para pesquisar um objeto especificado. Do ponto de vista do desempenho, esses métodos devem ser usados com cautela. Em muitas implementações, eles realizarão pesquisas lineares caras.

A List interface fornece dois métodos para inserir e remover com eficiência vários elementos em um ponto arbitrário da lista.

Nota: Embora seja permitido que as listas se contenham como elementos, recomenda-se extrema cautela: os equals métodos e hashCode não estão mais bem definidos em tal lista.

Algumas implementações de lista têm restrições sobre os elementos que podem conter. Por exemplo, algumas implementações proíbem elementos nulos e algumas têm restrições sobre os tipos de seus elementos. A tentativa de adicionar um elemento inelegível gera uma exceção não verificada, normalmente NullPointerException ou ClassCastException. A tentativa de consultar a presença de um elemento inelegível pode gerar uma exceção ou simplesmente retornar false; Algumas implementações exibirão o primeiro comportamento e outras exibirão o último. De forma mais geral, tentar uma operação em um elemento inelegível cuja conclusão não resultaria na inserção de um elemento inelegível na lista pode lançar uma exceção ou pode ser bem-sucedida, a critério da implementação. Essas exceções são marcadas como "opcionais" na especificação dessa interface.

<h2>"não modificável">Listas< não modificáveis/h2>

Os List#of(Object...) List.of métodos de fábrica estáticos e List#copyOf List.copyOf estáticos fornecem uma maneira conveniente de criar listas não modificáveis. As List instâncias criadas por esses métodos têm as seguintes características:

<ul li>Eles são <i>não modificáveis< / i>.<> Os elementos não podem ser adicionados, removidos ou substituídos. Chamar qualquer método mutador na Lista sempre fará com que UnsupportedOperationException seja lançado. No entanto, se os elementos contidos forem mutáveis, isso pode fazer com que o conteúdo da Lista pareça mudar. <li>Eles não permitem null elementos. As tentativas de criá-los com null elementos resultam em NullPointerException. <li>Eles são serializáveis se todos os elementos forem serializáveis. <li>A ordem dos elementos na lista é a mesma que a ordem dos argumentos fornecidos ou dos elementos na matriz fornecida. <li>As listas e seus #subList(int, int) subList modos de exibição implementam a RandomAccess interface. <li>Eles são baseados em valores. Os programadores devem tratar as instâncias que são #equals(Object) iguais como intercambiáveis e não devem usá-las para sincronização, ou pode ocorrer um comportamento imprevisível. Por exemplo, em uma versão futura, a sincronização pode falhar. Os chamadores não devem fazer suposições sobre a identidade das instâncias retornadas. As fábricas são livres para criar novas instâncias ou reutilizar as existentes. <li>Eles são serializados conforme especificado na página Formulário serializado. </ul>

Adicionado em 1.2.

Documentação Java para java.util.List.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.