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

CKTIS / Java

Iterable.iterator() — obter um iterador

O método `iterator()` devolve um iterador que permite percorrer os elementos de um `Iterable` sem recorrer a índices.

Versão: Java SE 21

Sintaxe

Iterator<T> iterator()

Iterable.iterator() é um método de instância sem argumentos, declarado em java.lang.Iterable<T>. A chamada source.iterator() devolve um java.util.Iterator<T>, não um elemento. O Iterable<T> é a fonte dos elementos do tipo T; o Iterator<T> acompanha a posição ao longo do percurso.

Chama hasNext() para verificar se ainda há outro elemento, sem o obter. next() devolve esse elemento e avança o iterador; se já não houver elementos, lança uma NoSuchElementException. O contrato geral de Iterable não define uma ordem de iteração. Por exemplo, o iterador de uma lista percorre os elementos do primeiro ao último.

Ao percorrer um Iterable, o ciclo for melhorado chama iterator() e depois usa hasNext() e next(). Para um array, usa índices em vez de um iterador. Usa um iterador explícito quando quiseres controlar o momento em que é obtido o elemento seguinte.

Exemplos

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

public class Main {
    public static void main(String[] args) {
        Iterable<String> colors = List.of("red", "green", "blue");
        Iterator<String> iterator = colors.iterator();

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

Resultado

red
green
blue

`colors.iterator()` obtém o iterador da lista. O ciclo imprime `red`, `green` e `blue`, um por linha, pela ordem dos elementos da lista.

Lições relacionadas

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

Fontes