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