Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

List.add(E) — ajouter un élément en fin de liste

`List.add(E)` ajoute un élément à la fin de la liste existante et renvoie `true` si l’appel se termine normalement. Toutes les listes ne permettent pas cet ajout.

Version : Java SE 21

Syntaxe

boolean add(E e)

boolean added = items.add(element);

List.add(E) est la méthode à un argument de java.util.List<E>. E est le type des éléments, par exemple Customer dans un dépôt qui s’appuie sur une List<Customer>. La méthode modifie la liste existante : le nouvel élément vient à la fin, sans changer l’ordre des éléments précédents. Si l’appel se termine normalement, il renvoie true, ni un indice ni une nouvelle liste.

La liste stocke la référence passée en argument, sans copier l’objet. Une ArrayList peut stocker plusieurs fois la même référence ; toute modification de l’objet partagé est visible à chaque position qui y fait référence. Les listes acceptent généralement les doublons : des appels successifs à add permettent donc de consigner des événements ou des destinataires dans leur ordre d’ajout.

L’ajout en fin de liste est facultatif : une liste obtenue avec List.of(...) n’est pas modifiable et lève UnsupportedOperationException. Même si elle accepte l’ajout, une liste peut refuser un élément : NullPointerException si null est interdit, ClassCastException si la classe de l’élément n’est pas acceptée, ou IllegalArgumentException si une autre propriété de l’élément est interdite. ArrayList accepte null.

La surcharge add(int index, E element) renvoie void et insère à un indice compris entre 0 et size() inclus, en décalant les éléments à partir de cette position. Pour annuler une suppression en rétablissant la position initiale, utilise l’indice mémorisé ; add(element) ajoute seulement à la fin. Depuis Java 21, addLast(E) ajoute aussi à la fin, mais renvoie void.

Exemples

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<StringBuilder> items = new ArrayList<>();
        StringBuilder first = new StringBuilder("Ada");

        boolean added = items.add(first);
        items.add(new StringBuilder("Lin"));
        items.add(first);

        System.out.println(added);
        System.out.println(items);
        System.out.println(items.get(0) == items.get(2));
        first.append("!");
        System.out.println(items);
    }
}

Résultat

true
[Ada, Lin, Ada]
true
[Ada!, Lin, Ada!]

Le premier `true` est le résultat de `add` ; le second vient de la comparaison des références avec `==`. Après la modification de `first`, les deux positions affichent `Ada!`, car elles font référence au même objet.

Leçons associées

  • Java · Leçon 21 · Intermédiaire · Version : 2
  • Java · Leçon 22 · Intermédiaire · Version : 2
  • Java · Leçon 26 · Intermédiaire · Version : 2
  • Java · Leçon 27 · Intermédiaire · Version : 2
  • Java · Leçon 32 · Intermédiaire · Version : 2

Sources