CKTIS / Java
List.remove(Object): eliminar la primera coincidencia
Elimina la primera aparición de un valor, como el nombre de un suscriptor, y usa el resultado `boolean` para saber si se eliminó algo. Distingue esta operación de la eliminación por índice.
Versión: Java SE 21
Sintaxis
boolean remove(Object o); // remove by value
E remove(int index); // remove by zero-based indexList.remove(Object) modifica la lista directamente. Solo elimina el elemento situado en el menor índice i para el que Objects.equals(o, get(i)) devuelve true. Las demás coincidencias se conservan. Si la llamada termina normalmente, devuelve true si elimina un elemento o false si no hay coincidencias y la lista no cambia. En unsubscribe, el argumento de tipo String es un nombre, no una posición.
La sobrecarga remove(int index) elimina el elemento del índice indicado, contado desde cero, y lo devuelve como tipo E. Un índice no válido provoca IndexOutOfBoundsException. Con List<Integer>, numbers.remove(1) elimina el elemento del índice 1, mientras que numbers.remove(Integer.valueOf(7)) elimina el primer valor 7. El compilador elige la sobrecarga según el tipo del argumento, no el tipo de retorno esperado: tiene prioridad una sobrecarga aplicable sin boxing ni unboxing.
La eliminación es opcional. ArrayList la admite, pero una lista obtenida con List.of(...) lanza UnsupportedOperationException incluso si no hay coincidencias. Según la implementación, la eliminación por valor también puede lanzar ClassCastException para un tipo incompatible o NullPointerException para null si la lista no admite null.
Ejemplos
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(...))` crea una copia modificable. Se elimina el primer `Ada`, el segundo permanece y la ausencia de `Sam` da `false`. En la lista de números se elimina primero `9`, que está en el índice `1`, y después el primer valor `7`.
Lecciones relacionadas
- Java · Lección 22 · Intermedio · Versión: 2
- Java · Lección 26 · Intermedio · Versión: 2