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 Iterator<E>

All Known Subinterfaces:

ListIterator<E>

All Known Implementing Classes:

BeanContextSupport.BCSIterator, Scanner

public interface Iterator<E>

Um iterador sobre uma coleção. Iterator substitui Enumaration no Java collections framework. Iterators são diferentes de enumerations de duas maneiras:

• Iterators permitem o chamador remover elementos da coleção de suporte durante a iteração, com semântica bem definida.
• Nomes de métodos foram melhorados.

Esta interface é um membro do Java Collections Framework.

Since:

1.2

See Also:

Collection, ListIterator, Enumeration

Method Summary

boolean	hasNext() Retorna true se a iteração tiver mais elementos.
E	next() Retorna o próximo elemento na iteração.
void	remove() Remove da coleção de suporte o último elemento retornado pelo iterator (operação opcional).

Method Detail

hasNext

boolean hasNext()

Retorna true se a iteração tiver mais elementos. (Em outras palavras, retorna true se next retornar um elemento ao invés de lançar uma exceção.)

Returns:

true se o iterator tiver mais elementos.

next

E next()

Retorna o próximo elemento na iteração. Chamando este método repetidamente até que o método hasNext() retorne false deve retornar cada elemento na coleção de suporte por vez.

Returns:

próximo elemento na iteração.

Throws:

NoSuchElementException - iteração não possui mais elementos.

remove

void remove()

Remove da coleção de suporte o último elemento retornado pelo iterator (operação opcional). Este método só pode ser chamado uma vez para cada chamada à next. O comportamento de um iterator não é especificado se a coleção de suporte for modificada, enquanto a iteração estiver em progresso, de outra maneira que não seja chamando esse método.

Throws:

UnsupportedOperationException - se a operação remove não for suportada por este Iterator.

IllegalStateException - se o método next ainda não foi chamado, ou o método remove já foi chamado depois da última chamada ao método next.