Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

java.util.List — uređena kolekcija elemenata

List<E> opisuje uređenu kolekciju s indeksima koji počinju od nule i koja obično dopušta duplikate. Nauči čitati, dodavati i uklanjati elemente te razlikovati promjenjivu listu, nepromjenjivu kopiju i pogled na raspon.

Verzija: Java SE 21; repository runtime, production runtime not attested

Sintaksa

List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);

java.util.List<E> sučelje je uređene kolekcije koja obično dopušta duplikate; E označava tip elementa. ArrayList je promjenjiva implementacija. List.size() daje broj elemenata, a List.isEmpty() provjerava je li lista prazna. List.get(i) čita element; valjani indeksi zadovoljavaju 0 <= i < size().

List.add(e) dodaje element na kraj, dok ga List.add(i, e) umeće na poziciju i; dopušteno je i i == size(). List.addAll(c) dodaje elemente prema redoslijedu iteracije kolekcije; List.addAll(i, c) umeće ih na zadanu poziciju. List.set(i, e) zamjenjuje element i vraća njegovu prethodnu vrijednost bez promjene veličine. List.clear() uklanja sve elemente.

List.contains(o) provjerava prisutnost prema jednakosti, a List.indexOf(o) vraća prvi indeks ili -1. List.remove(i) uklanja i vraća element na indeksu; List.remove(o) uklanja prvo jednako pojavljivanje i javlja je li se lista promijenila. Za List<Integer>, remove(1) uklanja prema indeksu, dok remove(Integer.valueOf(1)) uklanja prema vrijednosti.

List.of(...) stvara nepromjenjivu listu; List.copyOf(c) daje nepromjenjiv snimak na koji ne utječu kasnije promjene članstva izvorne kolekcije. Obje tvorničke metode odbijaju null. Ne kopiraju elemente dubinski: sadržani objekti i dalje se mogu mijenjati. Operacije mijenjanja neobavezne su u sučelju; liste dobivene ovim tvorničkim metodama pri pokušaju izmjene izbacuju UnsupportedOperationException.

List.subList(from, to) vraća pogled na [from, to), a ne neovisnu kopiju. Podržane promjene putem pogleda utječu na osnovnu listu; subList(from, to).clear() uklanja raspon. Strukturna promjena osnovne liste izvan pogleda čini semantiku pogleda nedefiniranom. U Javi 21 metoda u klasi ArrayList baca iznimku IndexOutOfBoundsException ako vrijedi from < 0 ili to > size(). U suprotnom, ako vrijedi from > to, baca iznimku IllegalArgumentException.

Primjeri

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

Rezultat

5 A
B
true 1
A
true
[X]
[X, C, D]
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori