CKTIS / Java
java.util.List — urejena zbirka elementov
List<E> opisuje urejeno zbirko z indeksi od nič, ki običajno dopušča dvojnike. Naučite se brati, dodajati in odstranjevati elemente ter razlikovati med spremenljivim seznamom, nespremenljivo kopijo in pogledom na obseg.
Različica: 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> je vmesnik za urejene zbirke, ki običajno dopuščajo dvojnike; E označuje vrsto elementa. ArrayList je spremenljiva implementacija. List.size() poda število elementov, List.isEmpty() pa preveri, ali je seznam prazen. List.get(i) prebere element; veljavni indeksi izpolnjujejo 0 <= i < size().
List.add(e) doda element na konec, List.add(i, e) pa ga vstavi na mesto i; dovoljen je tudi i == size(). List.addAll(c) doda elemente v vrstnem redu iteriranja zbirke; List.addAll(i, c) jih vstavi na določeno mesto. List.set(i, e) zamenja element in vrne njegovo prejšnjo vrednost, ne da bi spremenil velikost. List.clear() odstrani vse elemente.
List.contains(o) preveri prisotnost na podlagi enakosti, List.indexOf(o) pa vrne prvi indeks ali -1. List.remove(i) odstrani in vrne element na indeksu; List.remove(o) odstrani prvo enako pojavitev in sporoči, ali se je seznam spremenil. Pri List<Integer> remove(1) odstrani element po indeksu, remove(Integer.valueOf(1)) pa po vrednosti.
List.of(...) ustvari nespremenljiv seznam; List.copyOf(c) zagotovi nespremenljiv posnetek, na katerega poznejše spremembe članstva izvorne zbirke ne vplivajo. Obe tovarniški metodi zavrneta null. Elementov ne kopirata globinsko: vsebovani objekti se lahko še vedno spreminjajo. Operacije spreminjanja so v vmesniku neobvezne; seznami, ustvarjeni s tema tovarniškima metodama, ob poskusu spreminjanja sprožijo UnsupportedOperationException.
List.subList(from, to) vrne pogled na [from, to), ne samostojne kopije. Podprte spremembe prek pogleda vplivajo na osnovni seznam; subList(from, to).clear() odstrani obseg. Strukturna sprememba osnovnega seznama zunaj pogleda povzroči, da semantika pogleda ni določena. V Javi 21 metoda v ArrayList sproži izjemo IndexOutOfBoundsException, če velja from < 0 ali to > size(). Sicer, če velja from > to, sproži izjemo IllegalArgumentException.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.