CKTIS / Java
List.remove(Object): remover a primeira ocorrência
Remove a primeira ocorrência de um valor, como o nome de um subscritor, e usa o resultado `boolean` para saber se foi removido um elemento. Não confundas valor e índice.
Versão: Java SE 21
Sintaxe
boolean remove(Object o); // remove by value
E remove(int index); // remove by zero-based indexList.remove(Object) altera diretamente a lista. Remove apenas o elemento no menor índice i para o qual Objects.equals(o, get(i)) devolve true. As ocorrências seguintes mantêm-se. Se a chamada terminar normalmente, devolve true se removeu um elemento ou false se não encontrou correspondências e a lista ficou inalterada. Em unsubscribe, o argumento do tipo String é um nome, não uma posição.
A sobrecarga remove(int index) remove o elemento no índice indicado, contado a partir de zero, e devolve-o com o tipo E. Um índice inválido provoca IndexOutOfBoundsException. Numa List<Integer>, numbers.remove(1) remove o elemento no índice 1, enquanto numbers.remove(Integer.valueOf(7)) remove a primeira ocorrência do valor 7. O compilador escolhe a sobrecarga pelo tipo do argumento, não pelo tipo de retorno esperado: tem prioridade uma sobrecarga aplicável sem boxing nem unboxing.
A remoção é opcional. ArrayList suporta-a, mas uma lista obtida com List.of(...) lança UnsupportedOperationException, mesmo que não haja correspondência. Consoante a implementação, a remoção por valor pode também lançar ClassCastException para um tipo incompatível ou NullPointerException para null se a lista não aceitar null.
Exemplos
import java.util.ArrayList;
import java.util.List;
public class Main {
static boolean unsubscribe(List<String> names, String name) {
return names.remove(name);
}
public static void main(String[] args) {
List<String> names = new ArrayList<>(List.of("Ada", "Lin", "Ada"));
System.out.println(unsubscribe(names, "Ada"));
System.out.println(names);
System.out.println(unsubscribe(names, "Sam"));
System.out.println(names);
List<Integer> numbers = new ArrayList<>(List.of(7, 9, 7));
System.out.println(numbers.remove(1));
System.out.println(numbers.remove(Integer.valueOf(7)));
System.out.println(numbers);
}
}Resultado
true [Lin, Ada] false [Lin, Ada] 9 true [7]
Cada `new ArrayList<>(List.of(...))` cria uma cópia modificável. Remove-se o primeiro `Ada`, o segundo mantém-se e a ausência de `Sam` dá `false`. Na lista de números, remove-se primeiro `9` no índice `1` e depois a primeira ocorrência do valor `7`.
Lições relacionadas
- Java · Lição 22 · Intermédio · Versão: 2
- Java · Lição 26 · Intermédio · Versão: 2