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

CKTIS / Java

List.add — přidání prvku do seznamu

`List.add(E)` přidá jeden prvek na konec seznamu a při úspěchu vrátí `true`. Přetížená varianta s indexem vloží prvek na zvolenou pozici.

Verze: Java SE 21

Syntaxe

boolean add(E e)
void add(int index, E element)

V Java SE 21 má rozhraní java.util.List<E> dvě přetížené varianty List.add. Jednoargumentová metoda List.add(E) přidá prvek na konec existujícího seznamu. E označuje typ prvků, například String v List<String>. Metoda zachová pořadí dosavadních prvků a při úspěchu vrátí true, nikoli index ani nový seznam. ArrayList umožňuje duplicity i hodnoty null.

Varianta add(int index, E element) vloží prvek na pozici počítanou od nuly a má návratový typ void. Prvek na dané pozici a všechny následující prvky se posunou o jedno místo doprava. Při index == size() se prvek přidá na konec. Index mimo rozsah 0 <= index && index <= size() je neplatný a vyvolá IndexOutOfBoundsException, pokud seznam vkládání podporuje. Na rozdíl od set(index, element) vložení nenahrazuje žádný prvek.

Přidávání je volitelná operace: samotný typ List<E> nezaručuje, že konkrétní seznam přidávání umožňuje. Nepodporované volání vyvolá UnsupportedOperationException místo vrácení false. Seznam, který přidávání podporuje, může přesto odmítnout null výjimkou NullPointerException, nepovolený typ výjimkou ClassCastException nebo nepovolenou vlastnost prvku výjimkou IllegalArgumentException.

List.of(...) vytvoří neměnitelný seznam. Arrays.asList(...) vrátí seznam svázaný s polem: prvky lze nahradit, ale velikost je pevná. Ani jeden z těchto seznamů nepodporuje add. Pokud potřebuješ samostatný seznam, který může růst, použij new ArrayList<>(source). Přidání na konec kopie nezmění zdrojový seznam.

Příklady

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> source = List.of("alpha", "beta");
        List<String> tags = new ArrayList<>(source);

        boolean added = tags.add("alpha");
        tags.add(1, "gamma");

        System.out.println(added);
        System.out.println(tags);
        System.out.println(source);

        try {
            source.add("delta");
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException");
        }
    }
}

Výsledek

true
[alpha, gamma, beta, alpha]
[alpha, beta]
UnsupportedOperationException

Přidání druhého `alpha` na konec seznamu `tags` vrátí `true`. Vložení `gamma` na index `1` posune `beta` a druhé `alpha` doprava. Seznam `source` zůstane beze změny a pokus o přidání `delta` odmítne.

Související lekce

  • Java · Lekce 1 · Pokročilá · Verze: 2
  • Java · Lekce 2 · Pokročilá · Verze: 2
  • Java · Lekce 6 · Pokročilá · Verze: 2
  • Java · Lekce 8 · Pokročilá · Verze: 2
  • Java · Lekce 10 · Pokročilá · Verze: 2
  • Java · Lekce 13 · Pokročilá · Verze: 2
  • Java · Lekce 21 · Pokročilá · Verze: 2
  • Java · Lekce 33 · Pokročilá · Verze: 2
  • Java · Lekce 35 · Pokročilá · Verze: 2
  • Java · Lekce 36 · Pokročilá · Verze: 2
  • Java · Lekce 38 · Pokročilá · Verze: 2
  • Java · Lekce 19 · Základní · Verze: 2
  • Java · Lekce 29 · Základní · Verze: 2
  • Java · Lekce 39 · Základní · Verze: 2
  • Java · Lekce 44 · Základní · Verze: 2
  • Java · Lekce 54 · Základní · Verze: 2
  • Java · Lekce 57 · Základní · Verze: 2
  • Java · Lekce 59 · Základní · Verze: 2
  • Java · Lekce 62 · Základní · Verze: 2
  • Java · Lekce 2 · Středně pokročilá · Verze: 2
  • Java · Lekce 5 · Středně pokročilá · Verze: 2
  • Java · Lekce 6 · Středně pokročilá · Verze: 2
  • Java · Lekce 33 · Středně pokročilá · Verze: 2
  • Java · Lekce 34 · Středně pokročilá · Verze: 2
  • Java · Lekce 36 · Středně pokročilá · Verze: 2
  • Java · Lekce 39 · Středně pokročilá · Verze: 2
  • Java · Lekce 50 · Středně pokročilá · Verze: 2

Zdroje