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

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 index

List.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

Fontes