ISet Interface

Definição

[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

Derivado

Android.Util.ArraySet

Java.Util.AbstractSet

Java.Util.HashSet

Java.Util.INavigableSet

Java.Util.ISequencedSet

Mais…

Atributos

RegisterAttribute JavaTypeParametersAttribute

Implementações

IJavaObject IJavaPeerable IIterable ICollection IDisposable

Comentários

Uma coleção que não contém elementos duplicados. Mais formalmente, os conjuntos não contêm nenhum par de elementos e1 e e2 tal, e1.equals(e2)e no máximo um elemento nulo. Conforme implícito pelo nome, essa interface modela a abstração do conjunto matemático.

A Set interface coloca estipulações adicionais, além daquelas herdadas da Collection interface, nos contratos de todos os construtores e nos contratos dos métodos e hashCode .addequals Declarações para outros métodos herdados também são incluídas aqui para conveniência. (As especificações que acompanham essas declarações foram adaptadas para a Set interface, mas não contêm nenhuma estipulação adicional.)

A estipulação adicional em construtores é, não surpreendentemente, que todos os construtores devem criar um conjunto que não contenha elementos duplicados (conforme definido acima).

Observação: um grande cuidado deve ser exercido se objetos mutáveis forem usados como elementos definidos. O comportamento de um conjunto não será especificado se o valor de um objeto for alterado de uma maneira que afete equals comparações enquanto o objeto for um elemento no conjunto. Um caso especial dessa proibição é que não é permitido que um conjunto se contenha como um elemento.

Algumas implementações de conjunto 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 desmarcada, normalmente NullPointerException ou ClassCastException. A tentativa de consultar a presença de um elemento inelegível pode gerar uma exceção ou pode simplesmente retornar false; algumas implementações exibirão o comportamento anterior e algumas exibirão a última. De modo 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 no conjunto pode gerar uma exceção ou ter êxito, na opção da implementação. Essas exceções são marcadas como "opcionais" na especificação dessa interface.

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

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

<ul>li Eles são <i>unmodifiable</i>.>< Os elementos não podem ser adicionados ou removidos. Chamar qualquer método de mutador no Conjunto sempre causará UnsupportedOperationException a geração. No entanto, se os elementos contidos forem mutáveis, isso poderá fazer com que o Conjunto se comporte de forma inconsistente ou que seu conteúdo pareça ser alterado. <li>Eles não permitem null elementos. Tentativas de criá-los com null elementos resultam em NullPointerException. <li>Eles serão serializáveis se todos os elementos forem serializáveis. <li>Eles rejeitam elementos duplicados no momento da criação. Elementos duplicados passados para um método de fábrica estático resultam em IllegalArgumentException. <li>A ordem de iteração dos elementos do conjunto não é especificada e está sujeita a alterações. <li>Eles são baseados em valor. Os programadores devem tratar instâncias #equals(Object) iguais a intercambiáveis e não devem usá-las para sincronização ou 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>

Essa interface é um membro do Java Collections Framework.

Adicionado em 1.2.

Java documentação para java.util.Set.

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