CKTIS / Java
List.add(E) — pridanie prvku na koniec zoznamu
`List.add(E)` pridá jeden prvok na koniec existujúceho zoznamu a pri normálnom dokončení vráti `true`. Pridávanie nepodporujú všetky zoznamy.
Verzia: Java SE 21
Syntax
boolean add(E e)
boolean added = items.add(element);List.add(E) je metóda rozhrania java.util.List<E> s jedným argumentom. E je typ prvkov, napríklad Customer v repozitári založenom na List<Customer>. Metóda mení existujúci zoznam: nový prvok sa pridá na koniec a poradie doterajších prvkov zostane rovnaké. Pri normálnom dokončení vráti true, nie index ani nový zoznam.
Zoznam ukladá odovzdanú referenciu, nie kópiu objektu. ArrayList môže tú istú referenciu uložiť viackrát; zmenu zdieľaného objektu vidno na každej pozícii, ktorá naň odkazuje. Zoznamy zvyčajne povoľujú duplicity, takže opakovaným volaním add môžeš zaznamenávať udalosti alebo príjemcov v poradí, v akom ich pridávaš.
Pridanie na koniec je voliteľná operácia: zoznam vytvorený pomocou List.of(...) sa nedá meniť a vyvolá UnsupportedOperationException. Aj zoznam, ktorý pridávanie podporuje, môže prvok odmietnuť: vyvolá NullPointerException pre nepovolené null, ClassCastException pre nepovolenú triedu prvku alebo IllegalArgumentException pre inú nepovolenú vlastnosť prvku. ArrayList povoľuje null.
Preťažená metóda add(int index, E element) vracia void a vkladá na index od 0 do size() vrátane, pričom prvky od danej pozície posúva ďalej. Ak pri vracaní odstráneného prvku potrebuješ obnoviť jeho pôvodnú pozíciu, použi uložený index; add(element) pridáva iba na koniec. Od Javy 21 pridáva na koniec aj addLast(E), ale vracia void.
Príklady
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);
}
}Výsledok
true [Ada, Lin, Ada] true [Ada!, Lin, Ada!]
Prvé `true` je výsledok volania `add`; druhé je výsledok porovnania referencií pomocou `==`. Po zmene objektu `first` sa na oboch pozíciách zobrazí `Ada!`, pretože odkazujú na ten istý objekt.
Súvisiace lekcie
- Java · Lekcia 21 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 22 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 26 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 27 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 32 · Stredne pokročilá · Verzia: 2