CKTIS / Java
Iterable — um contrato para percorrer elementos
java.lang.Iterable<T> permite utilizar um objeto num ciclo for melhorado. O método iterator() fornece um iterador, enquanto o método predefinido forEach() aplica uma ação aos elementos sucessivos.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
public interface Iterable<T>
Iterator<T> iterator()
default void forEach(Consumer<? super T> action)java.lang.Iterable<T> permite utilizar um objeto num ciclo for melhorado; T indica o tipo dos elementos. É um contrato para percorrer elementos, não um contentor concreto.
Iterable.iterator() devolve um Iterator<T>. Distingue o objeto que fornece a iteração do iterador que acompanha o seu progresso: hasNext() verifica se existe um elemento disponível e next() obtém-no. Se não houver nenhum elemento disponível, next() lança uma NoSuchElementException.
Iterable.forEach(Consumer<? super T> action) é um método predefinido. Processa os elementos pela ordem de iteração, se esta estiver especificada. Uma exceção da ação interrompe o processamento e propaga-se ao chamador; uma ação null provoca uma NullPointerException. Não modifiques a origem na ação: o comportamento não está especificado, exceto se a implementação definir uma política adequada.
O exemplo implementa iterator() utilizando a lista ordenada List.of("A", "B") e herda forEach(). Neste caso, cada chamada a iterator() cria um novo iterador, pelo que ambos os percursos imprimem os dois elementos.
Exemplos
import java.util.Iterator;
import java.util.List;
public class Main implements Iterable<String> {
@Override
public Iterator<String> iterator() {
return List.of("A", "B").iterator();
}
public static void main(String[] args) {
Main letters = new Main();
for (String letter : letters) {
System.out.println("loop: " + letter);
}
letters.forEach(letter -> System.out.println("action: " + letter));
}
}Resultado
loop: A loop: B action: A action: B
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.