CKTIS / Java
Iterator.next() — obter o próximo elemento
`Iterator.next()` devolve o próximo elemento e faz avançar o iterador. Usa `hasNext()` para verificar se ainda há um elemento.
Versão: Java SE 21
Sintaxe
E next()
// Example call on an Iterator<String> named iterator:
String element = iterator.next();Iterator.next() é um método sem argumentos da interface java.util.Iterator<E>. Quando a chamada é bem-sucedida, devolve o próximo elemento do tipo E e faz avançar o iterador um elemento. Num Iterator<String>, o tipo devolvido é String. A chamada não remove o elemento da coleção.
hasNext() verifica se ainda há outro elemento sem fazer avançar o iterador. Num ciclo while (iterator.hasNext()), chama iterator.next() no corpo do ciclo. Não é necessário chamar hasNext() antes de cada next() se já souberes que ainda há um elemento.
Quando já não há elementos, next() lança java.util.NoSuchElementException: não devolve null para indicar o fim. Os elementos são devolvidos pela ordem de iteração da origem. List.iterator() percorre a lista desde o primeiro até ao último elemento.
Exemplos
import java.util.Iterator;
import java.util.List;
import java.util.NoSuchElementException;
public class IteratorNextDemo {
public static void main(String[] args) {
Iterator<String> iterator = List.of("A", "B").iterator();
while (iterator.hasNext()) {
String element = iterator.next();
System.out.println(element);
}
try {
iterator.next();
} catch (NoSuchElementException e) {
System.out.println("NoSuchElementException");
}
}
}Resultado
A B NoSuchElementException
O ciclo escreve `A` e `B` pela ordem da lista. Depois do ciclo, o programa chama propositadamente `next()` mais uma vez. O bloco `catch` interceta a exceção e escreve `NoSuchElementException`.
Lições relacionadas
- Java · Lição 57 · Básico · Versão: 2