CKTIS / Java
List.add — ajouter un élément à une liste
`List.add(E)` ajoute un élément à la fin d’une liste et renvoie `true` en cas de réussite. La surcharge avec indice insère un élément à la position choisie.
Version : Java SE 21
Syntaxe
boolean add(E e)
void add(int index, E element)Dans Java SE 21, l’interface java.util.List<E> définit deux surcharges de List.add. La méthode à un argument, List.add(E), ajoute un élément à la fin de la liste existante. E désigne le type des éléments, par exemple String dans List<String>. La méthode conserve l’ordre des éléments déjà présents et renvoie true en cas de réussite, et non un indice ou une nouvelle liste. ArrayList accepte les doublons et les valeurs null.
La surcharge add(int index, E element) insère à une position numérotée à partir de zéro et renvoie void. L’élément à cette position et les suivants sont décalés d’une place vers la droite. index == size() permet un ajout en fin de liste. Un indice hors de 0 <= index && index <= size() est invalide et provoque une IndexOutOfBoundsException si l’insertion est prise en charge. Contrairement à set(index, element), l’insertion ne remplace aucun élément.
L’ajout est facultatif : le type List<E> ne garantit pas à lui seul qu’une liste donnée accepte de nouveaux éléments. Si l’opération n’est pas prise en charge, l’appel lève une UnsupportedOperationException au lieu de renvoyer false. Une liste qui accepte les ajouts peut tout de même refuser null avec une NullPointerException, un type non autorisé avec une ClassCastException ou une propriété non autorisée de l’élément avec une IllegalArgumentException.
List.of(...) crée une liste non modifiable. Arrays.asList(...) renvoie une liste adossée à un tableau : on peut remplacer ses éléments, mais sa taille est fixe. Aucune des deux listes ne prend en charge add. Pour obtenir une liste distincte qui peut grandir, utilisez new ArrayList<>(source). Ajouter un élément à la fin de la copie ne modifie pas la liste source.
Exemples
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> source = List.of("alpha", "beta");
List<String> tags = new ArrayList<>(source);
boolean added = tags.add("alpha");
tags.add(1, "gamma");
System.out.println(added);
System.out.println(tags);
System.out.println(source);
try {
source.add("delta");
} catch (UnsupportedOperationException e) {
System.out.println("UnsupportedOperationException");
}
}
}Résultat
true [alpha, gamma, beta, alpha] [alpha, beta] UnsupportedOperationException
Ajouter un deuxième `alpha` à la fin de `tags` renvoie `true`. Insérer `gamma` à l’indice `1` décale `beta` et le deuxième `alpha` vers la droite. `source` reste inchangée et refuse l’ajout de `delta`.
Leçons associées
- Java · Leçon 1 · Avancé · Version : 2
- Java · Leçon 2 · Avancé · Version : 2
- Java · Leçon 6 · Avancé · Version : 2
- Java · Leçon 8 · Avancé · Version : 2
- Java · Leçon 10 · Avancé · Version : 2
- Java · Leçon 13 · Avancé · Version : 2
- Java · Leçon 21 · Avancé · Version : 2
- Java · Leçon 33 · Avancé · Version : 2
- Java · Leçon 35 · Avancé · Version : 2
- Java · Leçon 36 · Avancé · Version : 2
- Java · Leçon 38 · Avancé · Version : 2
- Java · Leçon 19 · Débutant · Version : 2
- Java · Leçon 29 · Débutant · Version : 2
- Java · Leçon 39 · Débutant · Version : 2
- Java · Leçon 44 · Débutant · Version : 2
- Java · Leçon 54 · Débutant · Version : 2
- Java · Leçon 57 · Débutant · Version : 2
- Java · Leçon 59 · Débutant · Version : 2
- Java · Leçon 62 · Débutant · Version : 2
- Java · Leçon 2 · Intermédiaire · Version : 2
- Java · Leçon 5 · Intermédiaire · Version : 2
- Java · Leçon 6 · Intermédiaire · Version : 2
- Java · Leçon 33 · Intermédiaire · Version : 2
- Java · Leçon 34 · Intermédiaire · Version : 2
- Java · Leçon 36 · Intermédiaire · Version : 2
- Java · Leçon 39 · Intermédiaire · Version : 2
- Java · Leçon 50 · Intermédiaire · Version : 2