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

CKTIS / Java

List.add(E) — añadir un elemento al final de una lista

`List.add(E)` añade un elemento al final de la lista existente y devuelve `true` si la llamada termina normalmente. No todas las listas admiten esta operación.

Versión: Java SE 21

Sintaxis

boolean add(E e)

boolean added = items.add(element);

List.add(E) es el método de un argumento de java.util.List<E>. E es el tipo de los elementos, como Customer en un repositorio que utiliza List<Customer>. El método modifica la lista existente: el elemento nuevo queda al final y los anteriores conservan su orden. Si la llamada termina normalmente, devuelve true, no un índice ni una lista nueva.

La lista guarda la referencia que le pasas, no una copia del objeto. Una ArrayList puede guardar la misma referencia varias veces; los cambios en el objeto compartido se ven desde cada posición que apunta a él. Las listas suelen admitir duplicados, así que las llamadas sucesivas a add sirven para registrar eventos o destinatarios en el orden en que se añaden.

Añadir al final es una operación opcional: una lista obtenida con List.of(...) no se puede modificar y lanza UnsupportedOperationException. Una lista que admite esta operación puede rechazar un elemento: NullPointerException si no admite null, ClassCastException si no admite la clase del elemento o IllegalArgumentException si no admite otra propiedad del elemento. ArrayList admite null.

La sobrecarga add(int index, E element) devuelve void e inserta en un índice entre 0 y size(), ambos incluidos, desplazando los elementos a partir de esa posición. Para deshacer una eliminación y recuperar la posición original, usa el índice guardado; add(element) solo añade al final. Desde Java 21, addLast(E) también añade al final, pero devuelve void.

Ejemplos

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

Resultado

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

El primer `true` es el resultado de `add`; el segundo es el resultado de comparar referencias con `==`. Tras modificar `first`, ambas posiciones muestran `Ada!` porque apuntan al mismo objeto.

Lecciones relacionadas

  • Java · Lección 21 · Intermedio · Versión: 2
  • Java · Lección 22 · Intermedio · Versión: 2
  • Java · Lección 26 · Intermedio · Versión: 2
  • Java · Lección 27 · Intermedio · Versión: 2
  • Java · Lección 32 · Intermedio · Versión: 2

Fuentes