Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje