Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

List.add(E) — dodajanje elementa na konec seznama

`List.add(E)` doda en element na konec obstoječega seznama in vrne `true`, če se klic normalno konča. Dodajanja ne podpirajo vsi seznami.

Različica: Java SE 21

Sintaksa

boolean add(E e)

boolean added = items.add(element);

List.add(E) je metoda vmesnika java.util.List<E> z enim argumentom. E je tip elementov, na primer Customer v repozitoriju, ki uporablja List<Customer>. Metoda spremeni obstoječi seznam: novi element doda na konec, prejšnji elementi pa ohranijo svoj vrstni red. Če se klic normalno konča, vrne true, ne indeksa ali novega seznama.

Seznam shrani podano referenco, ne kopije objekta. ArrayList lahko isto referenco shrani večkrat; spremembe skupnega objekta so vidne na vsakem mestu, ki se sklicuje nanj. Seznami običajno dovoljujejo dvojnike, zato lahko z zaporednimi klici add beležiš dogodke ali prejemnike v vrstnem redu dodajanja.

Dodajanje na konec je neobvezna operacija: seznama, ustvarjenega z List.of(...), ni mogoče spreminjati in klic sproži UnsupportedOperationException. Tudi seznam, ki podpira dodajanje, lahko element zavrne: z NullPointerException, če null ni dovoljen, s ClassCastException, če razred elementa ni dovoljen, ali z IllegalArgumentException, če ni dovoljena druga lastnost elementa. ArrayList dovoljuje null.

Preobremenjena metoda add(int index, E element) vrne void in vstavi element na indeks od 0 do vključno size(), pri tem pa premakne elemente od tega mesta naprej. Če želiš pri razveljavitvi odstranitve obnoviti prvotno mesto elementa, uporabi shranjeni indeks; add(element) ga doda samo na konec. Od Jave 21 tudi addLast(E) dodaja na konec, vendar vrne void.

Primeri

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` je rezultat klica `add`, drugi pa rezultat primerjave referenc z `==`. Po spremembi objekta `first` obe mesti prikažeta `Ada!`, ker se sklicujeta na isti objekt.

Povezane lekcije

  • Java · Lekcija 21 · Srednja · Različica: 2
  • Java · Lekcija 22 · Srednja · Različica: 2
  • Java · Lekcija 26 · Srednja · Različica: 2
  • Java · Lekcija 27 · Srednja · Različica: 2
  • Java · Lekcija 32 · Srednja · Različica: 2

Viri