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

CKTIS / Java

Iterator.hasNext(): verificar se há mais um elemento

`Iterator.hasNext()` verifica se um iterador pode devolver mais um elemento sem o consumir. Usa este método como condição do ciclo antes de chamar `next()`.

Versão: Java SE 21

Sintaxe

boolean hasNext();

Iterator.hasNext() é um método sem argumentos da interface java.util.Iterator<E> que devolve um boolean. Devolve true se houver mais um elemento disponível e false se o iterador não tiver mais elementos para devolver. Se o iterador não tiver elementos desde o início, a primeira verificação devolve false.

hasNext() não obtém nem salta nenhum elemento. Se não obtiveres nenhum elemento nem alterares a origem, uma nova chamada verifica o mesmo ponto do percurso. É next() que devolve o elemento seguinte, do tipo E, e faz avançar o iterador. Chamar next() quando o iterador está esgotado lança uma NoSuchElementException.

Num ciclo while (it.hasNext()), chama it.next() uma vez por iteração para obter um elemento. A condição verifica se ainda há algum elemento para aquele iterador, não se a coleção está vazia. O iterador pode esgotar-se mesmo que a coleção ainda contenha todos os seus elementos.

Exemplos

import java.util.Iterator;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        Iterator<String> it = List.of("A", "B").iterator();

        System.out.println(it.hasNext());
        System.out.println(it.hasNext());

        while (it.hasNext()) {
            System.out.println(it.next());
        }

        System.out.println(it.hasNext());
    }
}

Resultado

true
true
A
B
false

As duas verificações antes do ciclo escrevem `true`. O ciclo continua a escrever `A` e depois `B`, porque nenhuma das verificações consumiu um elemento. A última verificação escreve `false`.

Lições relacionadas

  • Java · Lição 57 · Básico · Versão: 2

Fontes