CKTIS / Java
java.util.List — una colección ordenada de elementos
List<E> describe una colección ordenada con índices que empiezan en cero y que normalmente permite duplicados. Aprende a leer, añadir y eliminar elementos, y a distinguir entre una lista modificable, una copia no modificable y una vista de rango.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);java.util.List<E> es una interfaz de colección ordenada que normalmente permite duplicados; E representa el tipo de elemento. ArrayList es una implementación modificable. List.size() indica el número de elementos y List.isEmpty() comprueba si la lista está vacía. List.get(i) lee un elemento; los índices válidos cumplen 0 <= i < size().
List.add(e) añade un elemento al final, mientras que List.add(i, e) lo inserta en la posición i; también se permite i == size(). List.addAll(c) añade elementos en el orden de iteración de la colección; List.addAll(i, c) los inserta en la posición indicada. List.set(i, e) reemplaza un elemento y devuelve su valor anterior sin cambiar el tamaño. List.clear() elimina todos los elementos.
List.contains(o) comprueba si un elemento está presente según la igualdad, y List.indexOf(o) devuelve el primer índice o -1. List.remove(i) elimina y devuelve el elemento del índice; List.remove(o) elimina la primera aparición igual e indica si la lista ha cambiado. Para List<Integer>, remove(1) elimina por índice, mientras que remove(Integer.valueOf(1)) elimina por valor.
List.of(...) crea una lista no modificable; List.copyOf(c) proporciona una instantánea no modificable que no se ve afectada si más adelante se añaden, eliminan o reemplazan elementos en la colección de origen. Ambas fábricas rechazan null. No realizan una copia profunda de los elementos: los objetos contenidos aún pueden cambiar. Las operaciones de modificación son opcionales en la interfaz; las listas de estas fábricas lanzan UnsupportedOperationException si se intenta modificarlas.
List.subList(from, to) devuelve una vista de [from, to), no una copia independiente. Los cambios admitidos a través de la vista afectan a la lista subyacente; subList(from, to).clear() elimina el rango. Un cambio estructural en la lista subyacente fuera de la vista hace que la semántica de esta quede indefinida. En Java 21, ArrayList lanza IndexOutOfBoundsException si from < 0 o to > size(). En caso contrario, si from > to, el método lanza IllegalArgumentException.
Ejemplos
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> items = new ArrayList<>(List.of("A", "B"));
items.add("C");
items.addAll(List.of("D", "E"));
System.out.println(items.size() + " " + items.get(0));
System.out.println(items.set(1, "X"));
System.out.println(items.contains("X") + " " + items.indexOf("X"));
System.out.println(items.remove(0));
System.out.println(items.remove("E"));
List<String> snapshot = List.copyOf(items);
items.subList(1, 3).clear();
System.out.println(items);
System.out.println(snapshot);
items.clear();
System.out.println(items.isEmpty());
}
}Resultado
5 A B true 1 A true [X] [X, C, D] true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.