Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.

java.util
Interface Map.Entry<K,V>

Enclosing interface:

Map<K,V>

public static interface Map.Entry<K,V>

Um map entry (par chave-valor). O método Map.entrySet retorna uma visão de coleção do map, cujo os elementos são deste tipo. A única maneira de obter uma referência para um map entry é a partir do iterator desta visão de coleção. Esses objetos Map.Entry são apenas válidos durante a iteração; mais formalmente, o comportamento do map entry é indefinido se o map de suporte for modificado depois que o entry for retornado pelo iterator, exceto através da operação setValue no map entry.

Since:

1.2

See Also:

Map.entrySet()

Method Summary

boolean	equals(Object o) Compara a igualdade do objeto especificado com este entry.
K	getKey() Retorna a chave correspondente a este entry.
V	getValue() Retorna o valor correspondente a este entry.
int	hashCode() Retorna o valor de código hash para este map entry.
V	setValue(V value) Substitui o valor correspondente a este entry com o valor especificado (operação opcional).

Method Detail

getKey

K getKey()

Retorna a chave correspondente a este entry.

Returns:

chave correspondente a este entry.

Throws:

IllegalStateException - implementações podem, mas não são obrigadas, a lançar essa exceção se o entry tiver sido removido do map de suporte.

getValue

V getValue()

Retorna o valor correspondente a este entry. Se o mapeamento tiver sido removido do map de suporte (pela operação remove do iterator), o resultado desta chamada será indefinida.

Returns:

valor correspondente a este entry.

Throws:

IllegalStateException - implementações podem, mas não são obrigadas, a lançar essa exceção se o entry tiver sido removido do map de suporte.

setValue

V setValue(V value)

Substitui o valor correspondente a este entry com o valor especificado (operação opcional). (Escreve no map.) O comportamento desta chamada será indefinida se o mapeamento tiver sido removido do map (pela operação remove do iterator).

Parameters:

value - novo valor a ser armazenado neste entry.

Returns:

old valor correspondente ao entry.

Throws:

UnsupportedOperationException - se a operação put não for suportada pelo map de suporte.

ClassCastException - se o tipo do valor especificado o previne de ser armazenado no map de suporte.

IllegalArgumentException - se algum aspecto deste valor o previne de ser armazenado no map de suporte.

NullPointerException - se o map de suporte não permitir valores null, e o valor especificado for null.

IllegalStateException - implementações podem, mas não são obrigadas, a lançar essa exceção se o entry tiver sido removido do map de suporte.

equals

boolean equals(Object o)

Compara a igualdade do objeto especificado com este entry. Retorna true se o dado objeto for também um map entry e os dois representam o mesmo mapeamento. Mais formalmente, dois entries e1 e e2 representam o mesmo mapeamento se

     (e1.getKey()==null ?
      e2.getKey()==null : e1.getKey().equals(e2.getKey()))  &&
     (e1.getValue()==null ?
      e2.getValue()==null : e1.getValue().equals(e2.getValue()))
 

Isto assegura que o método equals funcione apropriadamente entre diferentes implementações da interface Map.Entry.

Overrides:

equals in class Object

Parameters:

o - objeto a ser comparado por igualdade com este map entry.

Returns:

true se o objeto especificado for igual a este map entry.

See Also:

Object.hashCode(), Hashtable

hashCode

int hashCode()

Retorna o valor de código hash para este map entry. O código hash de um map entry e é definido para ser:

     (e.getKey()==null   ? 0 : e.getKey().hashCode()) ^
     (e.getValue()==null ? 0 : e.getValue().hashCode())
 

Isto assegura que e1.equals(e2) implica que e1.hashCode()==e2.hashCode() para quaisquer dois Entries e1 e e2, como requerido pelo contrato geral de Object.hashCode.

Overrides:

hashCode in class Object

Returns:

valor de código hash para este map entry.

See Also:

Object.hashCode(), Object.equals(Object), equals(Object)