CKTIS / Java
List.add — pridanie prvku do zoznamu
`List.add(E)` pridá jeden prvok na koniec zoznamu a pri úspechu vráti `true`. Preťažený variant s indexom vloží prvok na vybranú pozíciu.
Verzia: Java SE 21
Syntax
boolean add(E e)
void add(int index, E element)V Java SE 21 má rozhranie java.util.List<E> dva preťažené varianty List.add. Metóda s jedným argumentom, List.add(E), pridá prvok na koniec existujúceho zoznamu. E označuje typ prvkov, napríklad String v List<String>. Metóda zachová poradie pôvodných prvkov a pri úspechu vráti true, nie index ani nový zoznam. ArrayList povoľuje duplicity aj hodnoty null.
Variant add(int index, E element) vloží prvok na pozíciu počítanú od nuly a má návratový typ void. Prvok na tejto pozícii a všetky nasledujúce prvky sa posunú o jedno miesto doprava. Pri index == size() sa prvok pridá na koniec. Index mimo rozsahu 0 <= index && index <= size() je neplatný a vyvolá IndexOutOfBoundsException, ak zoznam vkladanie podporuje. Na rozdiel od set(index, element) vloženie nenahrádza žiadny prvok.
Pridávanie je voliteľná operácia: samotný typ List<E> nezaručuje, že konkrétny zoznam umožňuje pridávanie. Nepodporované volanie vyvolá UnsupportedOperationException namiesto vrátenia false. Zoznam, ktorý podporuje pridávanie, môže aj tak odmietnuť null výnimkou NullPointerException, nepovolený typ výnimkou ClassCastException alebo nepovolenú vlastnosť prvku výnimkou IllegalArgumentException.
List.of(...) vytvorí nemodifikovateľný zoznam. Arrays.asList(...) vráti zoznam prepojený s poľom: prvky možno nahradiť, ale veľkosť je pevná. Ani jeden z týchto zoznamov nepodporuje add. Ak potrebuješ samostatný zoznam, ktorý môže rásť, použi new ArrayList<>(source). Pridanie na koniec kópie nezmení zdrojový zoznam.
Prí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ýsledok
true [alpha, gamma, beta, alpha] [alpha, beta] UnsupportedOperationException
Pridanie druhého `alpha` na koniec zoznamu `tags` vráti `true`. Vloženie `gamma` na index `1` posunie `beta` a druhé `alpha` doprava. Zoznam `source` zostane nezmenený a pokus o pridanie `delta` odmietne.
Súvisiace lekcie
- Java · Lekcia 1 · Pokročilá · Verzia: 2
- Java · Lekcia 2 · Pokročilá · Verzia: 2
- Java · Lekcia 6 · Pokročilá · Verzia: 2
- Java · Lekcia 8 · Pokročilá · Verzia: 2
- Java · Lekcia 10 · Pokročilá · Verzia: 2
- Java · Lekcia 13 · Pokročilá · Verzia: 2
- Java · Lekcia 21 · Pokročilá · Verzia: 2
- Java · Lekcia 33 · Pokročilá · Verzia: 2
- Java · Lekcia 35 · Pokročilá · Verzia: 2
- Java · Lekcia 36 · Pokročilá · Verzia: 2
- Java · Lekcia 38 · Pokročilá · Verzia: 2
- Java · Lekcia 19 · Základná · Verzia: 2
- Java · Lekcia 29 · Základná · Verzia: 2
- Java · Lekcia 39 · Základná · Verzia: 2
- Java · Lekcia 44 · Základná · Verzia: 2
- Java · Lekcia 54 · Základná · Verzia: 2
- Java · Lekcia 57 · Základná · Verzia: 2
- Java · Lekcia 59 · Základná · Verzia: 2
- Java · Lekcia 62 · Základná · Verzia: 2
- Java · Lekcia 2 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 5 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 6 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 33 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 34 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 36 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 39 · Stredne pokročilá · Verzia: 2
- Java · Lekcia 50 · Stredne pokročilá · Verzia: 2