Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

List.add(E) — dodavanje elementa na kraj liste

`List.add(E)` dodaje jedan element na kraj postojeće liste i vraća `true` ako poziv završi bez iznimke. Ne podržavaju sve liste dodavanje.

Verzija: Java SE 21

Sintaksa

boolean add(E e)

boolean added = items.add(element);

List.add(E) metoda je sučelja java.util.List<E> s jednim argumentom. E je tip elemenata, primjerice Customer u repozitoriju koji se temelji na List<Customer>. Metoda mijenja postojeću listu: novi element završava na kraju, a prethodni elementi zadržavaju redoslijed. Ako poziv završi bez iznimke, metoda vraća true, a ne indeks ni novu listu.

Lista sprema proslijeđenu referencu, a ne kopiju objekta. ArrayList može spremiti istu referencu više puta; promjene zajedničkog objekta vidljive su na svakom položaju koji upućuje na njega. Liste uglavnom dopuštaju duplikate, pa uzastopnim pozivima add možeš bilježiti događaje ili primatelje redoslijedom dodavanja.

Dodavanje na kraj neobavezna je operacija: lista dobivena pozivom List.of(...) ne može se mijenjati i poziv baca UnsupportedOperationException. Čak i lista koja podržava dodavanje može odbiti element: NullPointerException ako null nije dopušten, ClassCastException ako klasa elementa nije dopuštena ili IllegalArgumentException ako neko drugo svojstvo elementa nije dopušteno. ArrayList dopušta null.

Preopterećena metoda add(int index, E element) vraća void i umeće element na indeks od 0 do size() uključivo, pomičući elemente od te pozicije nadalje. Ako pri poništavanju uklanjanja treba vratiti element na izvorno mjesto, upotrijebi spremljeni indeks; add(element) dodaje samo na kraj. Od Jave 21 i addLast(E) dodaje na kraj, ali vraća void.

Primjeri

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);
    }
}

Rezultat

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

Prvi `true` rezultat je poziva `add`, a drugi rezultat usporedbe referenci operatorom `==`. Nakon promjene objekta `first` na oba se položaja prikazuje `Ada!` jer upućuju na isti objekt.

Povezane lekcije

  • Java · Lekcija 21 · Srednje · Verzija: 2
  • Java · Lekcija 22 · Srednje · Verzija: 2
  • Java · Lekcija 26 · Srednje · Verzija: 2
  • Java · Lekcija 27 · Srednje · Verzija: 2
  • Java · Lekcija 32 · Srednje · Verzija: 2

Izvori