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

CKTIS / Java

List.clear(): esvaziar uma lista em Java

`List.clear()` remove todos os elementos de uma lista existente. O método não devolve nenhum valor e nem todas as listas suportam esta operação.

Versão: Java SE 21

Sintaxe

void clear()

list.clear();

List.clear() é um método de instância da interface java.util.List. Chama-se com list.clear(), sem argumentos. O tipo de retorno void indica que o método não devolve nenhum valor. Após uma chamada bem-sucedida, list.size() devolve 0 e list.isEmpty() devolve true.

O método altera a lista existente em vez de criar uma nova. Se duas variáveis fizerem referência à mesma lista, ambas passam a referir-se à lista vazia após a chamada. Atribuir uma nova lista a uma das variáveis não esvazia a lista original.

Esvaziar uma lista é uma operação opcional. ArrayList suporta-a, mas as listas criadas com List.of(...) ou List.copyOf(...) lançam UnsupportedOperationException, mesmo que já estejam vazias. Para esvaziar uma cópia sem alterar o original, cria primeiro new ArrayList<>(list) e chama clear() sobre a cópia.

Exemplos

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> items = new ArrayList<>(List.of("A", "B"));
        List<String> sameList = items;

        System.out.println(items.size());
        items.clear();
        System.out.println(items.size());
        System.out.println(sameList.isEmpty());
    }
}

Resultado

2
0
true

`items` e `sameList` referem-se à mesma `ArrayList`. A saída mostra o tamanho `2` antes da chamada, o tamanho `0` depois e `true` para `sameList.isEmpty()`.

Lições relacionadas

  • Java · Lição 54 · Básico · Versão: 2

Fontes