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

CKTIS / Java

List.addAll — ajouter en fin de liste ou insérer

Utilisez `List.addAll` pour ajouter les éléments d’une collection en fin de liste ou les insérer à un indice donné. Le résultat de type `boolean` indique si la liste de destination a changé.

Version : Java SE 21

Syntaxe

boolean addAll(Collection<? extends E> c)
boolean addAll(int index, Collection<? extends E> c)

Dans Java SE 21, l’interface java.util.List<E> propose deux surcharges de List.addAll. List.addAll(Collection) ajoute les éléments à la fin de la liste de destination dans l’ordre fourni par l’itérateur de la collection source. Si la source est une autre liste, ses éléments suivent ceux de la liste de destination dans leur ordre d’origine. La méthode ne trie pas et ne supprime pas les doublons. Collection<? extends E> signifie que la source n’a pas besoin d’être une liste et que son type d’élément déclaré peut être E ou un sous-type de E.

List.addAll(int, Collection) insère les éléments à partir d’un indice compté depuis zéro, dans le même ordre que dans la source. Les éléments déjà présents à cet indice et aux suivants sont décalés vers la droite. Les indices valides vont de 0 à size() inclus ; size() correspond à un ajout en fin de liste. Un indice hors de cet intervalle peut provoquer une IndexOutOfBoundsException.

Les deux surcharges modifient la liste sur laquelle elles sont appelées. Elles renvoient true si cette liste a changé, et false sinon. Par exemple, ajouter une collection vide à une ArrayList renvoie false. Le résultat n’est pas une nouvelle liste. Pour garder la première liste intacte, créez new ArrayList<>(first) et ajoutez les éléments de la seconde liste à cette copie.

L’ajout est facultatif : List.of(...) convient comme source, mais comme destination, cette liste déclenche une UnsupportedOperationException. Une liste de destination qui ne prend pas en charge l’opération peut lever cette exception avant de vérifier les arguments. Un argument null peut provoquer une NullPointerException, tout comme un élément null si la destination le refuse. Des restrictions sur la classe ou sur d’autres propriétés d’un élément peuvent provoquer respectivement une ClassCastException ou une IllegalArgumentException. Ne modifiez pas la source pendant l’appel : le comportement n’est alors pas défini, y compris si une liste non vide est sa propre source.

Exemples

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

public class Main {
    public static void main(String[] args) {
        List<String> first = List.of("A", "B");
        List<String> second = List.of("B", "C");
        List<String> result = new ArrayList<>(first);

        System.out.println(result.addAll(second));
        System.out.println(result);

        result.addAll(1, List.of("X", "Y"));
        System.out.println(result);
        System.out.println(result.addAll(List.of()));
    }
}

Résultat

true
[A, B, B, C]
[A, X, Y, B, B, C]
false

Le programme crée une copie modifiable de `first`. L’ajout de `second` renvoie `true` et conserve les deux occurrences de `B`. L’insertion à l’indice `1` place `X` et `Y` après `A`. L’ajout d’une collection vide renvoie `false`.

Leçons associées

  • Java · Leçon 14 · Avancé · Version : 2
  • Java · Leçon 54 · Débutant · Version : 2

Sources