CKTIS / Java
Iterator — percorrer os elementos de uma coleção
Um iterator lê sequencialmente os elementos de uma coleção e, se a operação opcional remove for suportada, pode eliminá-los durante o percurso.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Iterator<E> it = collection.iterator();
while (it.hasNext()) {
E element = it.next();
// it.remove(); // optional operation
}java.util.Iterator<E> representa um percurso pelos elementos do tipo E. Iterator.hasNext() verifica se existe outro elemento disponível; Iterator.next() obtém-no e avança o iterador. Quando já não há elementos, next() lança NoSuchElementException.
Se o iterador suportar a remoção, Iterator.remove() elimina o último elemento obtido. Chamar remove() antes da primeira chamada a next() ou voltar a chamar remove() sem uma chamada intermédia a next() provoca IllegalStateException. A remoção é opcional: a implementação predefinida de remove() lança sempre UnsupportedOperationException, mesmo antes da primeira chamada a next().
O exemplo elimina os números pares de um ArrayList através do seu iterador. Durante este percurso, não adiciones nem elimines elementos diretamente na lista. Os iteradores da lista procuram detetar essas alterações, mas não há garantia de deteção; ConcurrentModificationException não garante segurança entre threads.
Exemplos
import java.util.ArrayList;
import java.util.Iterator;
public class Main {
public static void main(String[] args) {
ArrayList<Integer> numbers = new ArrayList<>();
numbers.add(1);
numbers.add(2);
numbers.add(3);
numbers.add(4);
Iterator<Integer> it = numbers.iterator();
while (it.hasNext()) {
int number = it.next();
if (number % 2 == 0) {
it.remove();
}
}
System.out.println(numbers);
}
}Resultado
[1, 3]
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.