CKTIS / Java
List.remove(Object) : supprimer la première occurrence
Supprimez la première occurrence d’une valeur, par exemple un nom, et utilisez le résultat `boolean` pour savoir si la liste a changé. Ne confondez pas valeur et indice.
Version : Java SE 21
Syntaxe
boolean remove(Object o); // remove by value
E remove(int index); // remove by zero-based indexList.remove(Object) modifie la liste sur place. La méthode ne supprime que l’élément au plus petit indice i pour lequel Objects.equals(o, get(i)) vaut true. Les occurrences suivantes restent en place. Si l’appel se termine normalement, il renvoie true si un élément a été supprimé, ou false si rien ne correspond et que la liste reste inchangée. Dans unsubscribe, l’argument de type String est un nom, pas une position.
La surcharge remove(int index) supprime l’élément à l’indice indiqué, compté à partir de zéro, et le renvoie avec le type E. Un indice non valide provoque une IndexOutOfBoundsException. Avec List<Integer>, numbers.remove(1) supprime l’élément à l’indice 1, tandis que numbers.remove(Integer.valueOf(7)) supprime la première valeur 7. Le compilateur choisit la surcharge selon le type de l’argument, pas selon le type de retour attendu : une surcharge applicable sans boxing ni unboxing est prioritaire.
La suppression est facultative. ArrayList la prend en charge, mais une liste obtenue avec List.of(...) lève une UnsupportedOperationException, même sans correspondance. Selon l’implémentation, la suppression par valeur peut aussi lever une ClassCastException pour un type incompatible ou une NullPointerException pour null si la liste n’accepte pas null.
Exemples
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);
}
}Résultat
true [Lin, Ada] false [Lin, Ada] 9 true [7]
Chaque `new ArrayList<>(List.of(...))` crée une copie modifiable. Le premier `Ada` est supprimé, le second reste et l’absence de `Sam` donne `false`. Dans la liste de nombres, on supprime d’abord `9` à l’indice `1`, puis la première valeur `7`.
Leçons associées
- Java · Leçon 22 · Intermédiaire · Version : 2
- Java · Leçon 26 · Intermédiaire · Version : 2