CKTIS / Java
List.add — añadir un elemento a una lista
`List.add(E)` añade un elemento al final de una lista y devuelve `true` si lo consigue. La sobrecarga con índice inserta un elemento en la posición elegida.
Versión: Java SE 21
Sintaxis
boolean add(E e)
void add(int index, E element)En Java SE 21, la interfaz java.util.List<E> ofrece dos sobrecargas de List.add. El método de un argumento, List.add(E), añade un elemento al final de la lista existente. E es el tipo de los elementos, como String en List<String>. El método conserva el orden de los elementos que ya estaban en la lista y, si la adición se realiza correctamente, devuelve true, no un índice ni una lista nueva. ArrayList admite duplicados y valores null.
La sobrecarga add(int index, E element) inserta en una posición numerada a partir de cero y devuelve void. El elemento de esa posición y los posteriores se desplazan un lugar a la derecha. Con index == size() se añade al final. Un índice fuera de 0 <= index && index <= size() no es válido y provoca una IndexOutOfBoundsException si la inserción está admitida. A diferencia de set(index, element), la inserción no sustituye ningún elemento.
Añadir es una operación opcional: el tipo List<E> por sí solo no garantiza que una lista concreta admita adiciones. Una llamada no admitida lanza UnsupportedOperationException en vez de devolver false. Aunque una lista admita adiciones, puede rechazar null con NullPointerException, un tipo no permitido con ClassCastException o una propiedad no permitida del elemento con IllegalArgumentException.
List.of(...) crea una lista no modificable. Arrays.asList(...) devuelve una lista respaldada por un array en la que se pueden sustituir elementos, pero cuyo tamaño es fijo. Ninguna admite add. Si necesitas una lista independiente que pueda crecer, usa new ArrayList<>(source). Añadir un elemento al final de la copia no modifica la lista de origen.
Ejemplos
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");
}
}
}Resultado
true [alpha, gamma, beta, alpha] [alpha, beta] UnsupportedOperationException
Añadir un segundo `alpha` al final de `tags` devuelve `true`. Insertar `gamma` en el índice `1` desplaza `beta` y el segundo `alpha` a la derecha. `source` no cambia y rechaza el intento de añadir `delta`.
Lecciones relacionadas
- Java · Lección 1 · Avanzado · Versión: 2
- Java · Lección 2 · Avanzado · Versión: 2
- Java · Lección 6 · Avanzado · Versión: 2
- Java · Lección 8 · Avanzado · Versión: 2
- Java · Lección 10 · Avanzado · Versión: 2
- Java · Lección 13 · Avanzado · Versión: 2
- Java · Lección 21 · Avanzado · Versión: 2
- Java · Lección 33 · Avanzado · Versión: 2
- Java · Lección 35 · Avanzado · Versión: 2
- Java · Lección 36 · Avanzado · Versión: 2
- Java · Lección 38 · Avanzado · Versión: 2
- Java · Lección 19 · Básico · Versión: 2
- Java · Lección 29 · Básico · Versión: 2
- Java · Lección 39 · Básico · Versión: 2
- Java · Lección 44 · Básico · Versión: 2
- Java · Lección 54 · Básico · Versión: 2
- Java · Lección 57 · Básico · Versión: 2
- Java · Lección 59 · Básico · Versión: 2
- Java · Lección 62 · Básico · Versión: 2
- Java · Lección 2 · Intermedio · Versión: 2
- Java · Lección 5 · Intermedio · Versión: 2
- Java · Lección 6 · Intermedio · Versión: 2
- Java · Lección 33 · Intermedio · Versión: 2
- Java · Lección 34 · Intermedio · Versión: 2
- Java · Lección 36 · Intermedio · Versión: 2
- Java · Lección 39 · Intermedio · Versión: 2
- Java · Lección 50 · Intermedio · Versión: 2