Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes