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

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

Fontes