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