CKTIS / Java
Iterator.remove() — remover um elemento durante a iteração
Iterator.remove() remove da coleção subjacente o último elemento devolvido por next(), se o iterador suportar a remoção.
Versão: Java SE 21
Sintaxe
default void remove()Iterator.remove() é um método predefinido da interface java.util.Iterator<E>. É chamado no iterador, por exemplo, com it.remove(). Não recebe argumentos nem devolve um valor (void). Remove da coleção subjacente precisamente o último elemento que esse iterador devolveu através de next(). Não se indica um índice nem um valor.
Depois de uma chamada bem-sucedida a next(), só podes remover uma vez o elemento devolvido. hasNext() apenas verifica se existe outro elemento. Um iterador que suporta a remoção lança IllegalStateException se chamares remove() antes da primeira chamada bem-sucedida a next() ou se voltares a chamar remove() sem uma nova chamada bem-sucedida a next().
A remoção é opcional. A implementação predefinida não altera nada e lança UnsupportedOperationException. O iterador de uma ArrayList suporta a remoção, mas o de uma lista não modificável criada com List.of() não a suporta.
Não substituas it.remove() por uma alteração direta da coleção durante a iteração: o comportamento do iterador não está especificado, a menos que a implementação documente uma política para modificações concorrentes. O contrato de Iterator também não especifica o comportamento de remove() após forEachRemaining().
Exemplos
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<Integer> numbers = new ArrayList<>(List.of(1, 2, 4, 5));
Iterator<Integer> it = numbers.iterator();
while (it.hasNext()) {
int number = it.next();
if (number % 2 == 0) {
it.remove();
}
}
System.out.println(numbers);
}
}Resultado
[1, 5]
`List.of()` fornece os valores iniciais e `ArrayList` cria uma cópia modificável. O ciclo remove os números pares adjacentes `2` e `4`, cada um após uma chamada distinta a `next()`, e apresenta `[1, 5]`.
Lições relacionadas
- Java · Lição 57 · Básico · Versão: 2