CKTIS / Java
List.add(E) — dodajanje elementa na konec seznama
`List.add(E)` doda en element na konec obstoječega seznama in vrne `true`, če se klic normalno konča. Dodajanja ne podpirajo vsi seznami.
Različica: Java SE 21
Sintaksa
boolean add(E e)
boolean added = items.add(element);List.add(E) je metoda vmesnika java.util.List<E> z enim argumentom. E je tip elementov, na primer Customer v repozitoriju, ki uporablja List<Customer>. Metoda spremeni obstoječi seznam: novi element doda na konec, prejšnji elementi pa ohranijo svoj vrstni red. Če se klic normalno konča, vrne true, ne indeksa ali novega seznama.
Seznam shrani podano referenco, ne kopije objekta. ArrayList lahko isto referenco shrani večkrat; spremembe skupnega objekta so vidne na vsakem mestu, ki se sklicuje nanj. Seznami običajno dovoljujejo dvojnike, zato lahko z zaporednimi klici add beležiš dogodke ali prejemnike v vrstnem redu dodajanja.
Dodajanje na konec je neobvezna operacija: seznama, ustvarjenega z List.of(...), ni mogoče spreminjati in klic sproži UnsupportedOperationException. Tudi seznam, ki podpira dodajanje, lahko element zavrne: z NullPointerException, če null ni dovoljen, s ClassCastException, če razred elementa ni dovoljen, ali z IllegalArgumentException, če ni dovoljena druga lastnost elementa. ArrayList dovoljuje null.
Preobremenjena metoda add(int index, E element) vrne void in vstavi element na indeks od 0 do vključno size(), pri tem pa premakne elemente od tega mesta naprej. Če želiš pri razveljavitvi odstranitve obnoviti prvotno mesto elementa, uporabi shranjeni indeks; add(element) ga doda samo na konec. Od Jave 21 tudi addLast(E) dodaja na konec, vendar vrne void.
Primeri
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<StringBuilder> items = new ArrayList<>();
StringBuilder first = new StringBuilder("Ada");
boolean added = items.add(first);
items.add(new StringBuilder("Lin"));
items.add(first);
System.out.println(added);
System.out.println(items);
System.out.println(items.get(0) == items.get(2));
first.append("!");
System.out.println(items);
}
}Rezultat
true [Ada, Lin, Ada] true [Ada!, Lin, Ada!]
Prvi `true` je rezultat klica `add`, drugi pa rezultat primerjave referenc z `==`. Po spremembi objekta `first` obe mesti prikažeta `Ada!`, ker se sklicujeta na isti objekt.
Povezane lekcije
- Java · Lekcija 21 · Srednja · Različica: 2
- Java · Lekcija 22 · Srednja · Različica: 2
- Java · Lekcija 26 · Srednja · Različica: 2
- Java · Lekcija 27 · Srednja · Različica: 2
- Java · Lekcija 32 · Srednja · Različica: 2