Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

List.addAll — añadir al final o insertar elementos

Usa `List.addAll` para añadir los elementos de una colección al final de una lista o insertarlos en un índice concreto. El resultado de tipo `boolean` indica si cambió la lista de destino.

Versión: Java SE 21

Sintaxis

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

En Java SE 21, la interfaz java.util.List<E> ofrece dos sobrecargas de List.addAll. List.addAll(Collection) añade elementos al final de la lista de destino en el orden en que los devuelve el iterador de la colección de origen. Si el origen es otra lista, sus elementos quedan después de los que ya estaban en el destino, en su orden original. El método no ordena ni elimina duplicados. Collection<? extends E> significa que el origen no tiene que ser una lista y que el tipo declarado de sus elementos puede ser E o un subtipo de E.

List.addAll(int, Collection) inserta los elementos a partir de un índice que se cuenta desde cero y mantiene el mismo orden del origen. Los elementos existentes a partir del punto de inserción se desplazan hacia la derecha. Los índices válidos van de 0 a size(), ambos incluidos; size() equivale a añadir al final. Un índice fuera de ese intervalo puede provocar una IndexOutOfBoundsException.

Ambas sobrecargas modifican la lista sobre la que se invocan. Devuelven true si la lista cambió y false si no cambió. Por ejemplo, añadir una colección vacía a un ArrayList devuelve false. El resultado no es una lista nueva. Para conservar la primera lista sin cambios, crea new ArrayList<>(first) y añade a esa copia los elementos de la segunda lista.

Añadir elementos es opcional: List.of(...) sirve como origen, pero como destino lanza UnsupportedOperationException. Si la lista de destino no admite la operación, puede lanzar esa excepción antes de comprobar los argumentos. Un argumento null puede provocar NullPointerException, al igual que un elemento null si el destino no lo admite. Las restricciones sobre la clase u otras propiedades de un elemento pueden provocar ClassCastException o IllegalArgumentException, respectivamente. No modifiques el origen durante la llamada: el comportamiento queda indefinido, incluso si una lista no vacía se usa como su propio origen.

Ejemplos

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()));
    }
}

Resultado

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

El programa crea una copia modificable de `first`. Añadir `second` al final devuelve `true` y conserva las dos apariciones de `B`. Insertar en el índice `1` coloca `X` e `Y` después de `A`. Añadir una colección vacía devuelve `false`.

Lecciones relacionadas

  • Java · Lección 14 · Avanzado · Versión: 2
  • Java · Lección 54 · Básico · Versión: 2

Fuentes