CKTIS / Java
List.clear(): vaciar una lista en Java
`List.clear()` elimina todos los elementos de una lista existente. El método no devuelve ningún valor y no todas las listas admiten esta operación.
Versión: Java SE 21
Sintaxis
void clear()
list.clear();List.clear() es un método de instancia de la interfaz java.util.List. Se invoca como list.clear(), sin argumentos. Su tipo de retorno, void, indica que no devuelve ningún valor. Si la llamada se completa correctamente, list.size() devuelve 0 y list.isEmpty() devuelve true.
El método modifica la lista existente en lugar de crear otra. Si dos variables hacen referencia a la misma lista, ambas ven la lista vacía tras la llamada. Asignar una lista nueva a una de las variables no vacía la lista original.
Vaciar una lista es una operación opcional. ArrayList la admite, pero las listas creadas con List.of(...) o List.copyOf(...) lanzan UnsupportedOperationException, incluso si ya están vacías. Para vaciar una copia sin modificar la lista original, crea primero new ArrayList<>(list) y llama a clear() sobre la copia.
Ejemplos
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` y `sameList` hacen referencia a la misma `ArrayList`. La salida muestra el tamaño `2` antes de la llamada, el tamaño `0` después y `true` para `sameList.isEmpty()`.
Lecciones relacionadas
- Java · Lección 54 · Básico · Versión: 2