CKTIS / Java
List.add — dodavanje elementa na popis
`List.add(E)` dodaje jedan element na kraj popisa i nakon uspješnog dodavanja vraća `true`. Preopterećena inačica s indeksom umeće element na odabrano mjesto.
Verzija: Java SE 21
Sintaksa
boolean add(E e)
void add(int index, E element)U Java SE 21 sučelje java.util.List<E> ima dvije preopterećene inačice metode List.add. Inačica s jednim argumentom, List.add(E), dodaje element na kraj postojećeg popisa. E označava tip elemenata, primjerice String u List<String>. Metoda zadržava redoslijed postojećih elemenata i nakon uspješnog dodavanja vraća true, a ne indeks ili novi popis. ArrayList dopušta duplikate i vrijednosti null.
Inačica add(int index, E element) umeće element na mjesto čiji se indeks broji od nule i ima povratni tip void. Element na tom mjestu i svi sljedeći elementi pomiču se za jedno mjesto udesno. Ako je index == size(), element se dodaje na kraj. Indeks izvan raspona 0 <= index && index <= size() nije valjan i uzrokuje IndexOutOfBoundsException ako je umetanje podržano. Za razliku od set(index, element), umetanje ne zamjenjuje nijedan element.
Dodavanje je neobavezna operacija: sam tip List<E> ne jamči da određeni popis podržava dodavanje. Nepodržani poziv baca UnsupportedOperationException umjesto da vrati false. Popis koji podržava dodavanje ipak može odbiti null iznimkom NullPointerException, nedopušten tip iznimkom ClassCastException ili nedopušteno svojstvo elementa iznimkom IllegalArgumentException.
List.of(...) stvara popis koji se ne može mijenjati. Arrays.asList(...) vraća popis povezan s nizom: elementi se mogu zamijeniti, ali veličina je fiksna. Nijedan od tih popisa ne podržava add. Ako ti treba zaseban popis koji može rasti, upotrijebi new ArrayList<>(source). Dodavanje na kraj kopije ne mijenja izvorni popis.
Primjeri
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");
}
}
}Rezultat
true [alpha, gamma, beta, alpha] [alpha, beta] UnsupportedOperationException
Dodavanje drugog elementa `alpha` na kraj popisa `tags` vraća `true`. Umetanje elementa `gamma` na indeks `1` pomiče `beta` i drugi `alpha` udesno. Popis `source` ostaje nepromijenjen i odbija pokušaj dodavanja elementa `delta`.
Povezane lekcije
- Java · Lekcija 1 · Napredno · Verzija: 2
- Java · Lekcija 2 · Napredno · Verzija: 2
- Java · Lekcija 6 · Napredno · Verzija: 2
- Java · Lekcija 8 · Napredno · Verzija: 2
- Java · Lekcija 10 · Napredno · Verzija: 2
- Java · Lekcija 13 · Napredno · Verzija: 2
- Java · Lekcija 21 · Napredno · Verzija: 2
- Java · Lekcija 33 · Napredno · Verzija: 2
- Java · Lekcija 35 · Napredno · Verzija: 2
- Java · Lekcija 36 · Napredno · Verzija: 2
- Java · Lekcija 38 · Napredno · Verzija: 2
- Java · Lekcija 19 · Osnovno · Verzija: 2
- Java · Lekcija 29 · Osnovno · Verzija: 2
- Java · Lekcija 39 · Osnovno · Verzija: 2
- Java · Lekcija 44 · Osnovno · Verzija: 2
- Java · Lekcija 54 · Osnovno · Verzija: 2
- Java · Lekcija 57 · Osnovno · Verzija: 2
- Java · Lekcija 59 · Osnovno · Verzija: 2
- Java · Lekcija 62 · Osnovno · Verzija: 2
- Java · Lekcija 2 · Srednje · Verzija: 2
- Java · Lekcija 5 · Srednje · Verzija: 2
- Java · Lekcija 6 · Srednje · Verzija: 2
- Java · Lekcija 33 · Srednje · Verzija: 2
- Java · Lekcija 34 · Srednje · Verzija: 2
- Java · Lekcija 36 · Srednje · Verzija: 2
- Java · Lekcija 39 · Srednje · Verzija: 2
- Java · Lekcija 50 · Srednje · Verzija: 2