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

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.

Fuentes