Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

List.add(E) — přidání prvku na konec seznamu

`List.add(E)` přidá jeden prvek na konec existujícího seznamu a při normálním dokončení vrátí `true`. Přidávání nepodporují všechny seznamy.

Verze: Java SE 21

Syntaxe

boolean add(E e)

boolean added = items.add(element);

List.add(E) je metoda rozhraní java.util.List<E> s jedním argumentem. E je typ prvků, například Customer v repozitáři založeném na List<Customer>. Metoda mění existující seznam: nový prvek se přidá na konec a pořadí dosavadních prvků zůstane stejné. Při normálním dokončení vrátí true, nikoli index ani nový seznam.

Seznam ukládá předanou referenci, ne kopii objektu. ArrayList může stejnou referenci uložit vícekrát; změnu sdíleného objektu uvidíš na každé pozici, která na něj odkazuje. Seznamy obvykle povolují duplicity, takže opakovaným voláním add lze zaznamenávat události nebo příjemce v pořadí, v jakém je přidáváš.

Přidání na konec je volitelná operace: seznam vytvořený pomocí List.of(...) nelze měnit a vyvolá UnsupportedOperationException. I seznam, který přidávání podporuje, může prvek odmítnout: vyvolá NullPointerException pro nepovolené null, ClassCastException pro nepovolenou třídu prvku nebo IllegalArgumentException pro jinou nepovolenou vlastnost prvku. ArrayList povoluje null.

Přetížená metoda add(int index, E element) vrací void a vkládá na index od 0 do size() včetně. Prvky od dané pozice posune dál. Pokud při vracení odstraněného prvku potřebuješ obnovit jeho původní pozici, použij uložený index; add(element) přidává pouze na konec. Od Javy 21 přidává na konec také addLast(E), ale vrací void.

Pří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ýsledek

true
[Ada, Lin, Ada]
true
[Ada!, Lin, Ada!]

První `true` je návratová hodnota metody `add`; druhé je výsledkem porovnání referencí operátorem `==`. Po změně objektu `first` se na obou pozicích zobrazí `Ada!`, protože odkazují na stejný objekt.

Související lekce

  • Java · Lekce 21 · Středně pokročilá · Verze: 2
  • Java · Lekce 22 · Středně pokročilá · Verze: 2
  • Java · Lekce 26 · Středně pokročilá · Verze: 2
  • Java · Lekce 27 · Středně pokročilá · Verze: 2
  • Java · Lekce 32 · Středně pokročilá · Verze: 2

Zdroje