Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes