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

CKTIS / Java

List.add — dodajanje elementa na seznam

`List.add(E)` doda en element na konec seznama in ob uspehu vrne `true`. Preobremenjena različica z indeksom vstavi element na izbrano mesto.

Različica: Java SE 21

Sintaksa

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

V Java SE 21 ima vmesnik java.util.List<E> dve preobremenjeni različici metode List.add. Različica z enim argumentom, List.add(E), doda element na konec obstoječega seznama. E je tip elementov, na primer String v List<String>. Metoda ohrani vrstni red obstoječih elementov in ob uspehu vrne true, ne indeksa ali novega seznama. ArrayList dovoljuje podvojene elemente in vrednosti null.

Različica add(int index, E element) vstavi element na mesto z indeksom, ki se šteje od nič, in ima povratni tip void. Element na tem mestu in vsi naslednji se premaknejo za eno mesto v desno. Pri index == size() se element doda na konec. Indeks zunaj območja 0 <= index && index <= size() je neveljaven in sproži IndexOutOfBoundsException, če seznam podpira vstavljanje. V nasprotju z set(index, element) vstavljanje ne zamenja nobenega elementa.

Dodajanje je neobvezna operacija: sam tip List<E> ne zagotavlja, da določen seznam podpira dodajanje. Nepodprt klic sproži UnsupportedOperationException, namesto da bi vrnil false. Seznam, ki podpira dodajanje, lahko vseeno zavrne null z izjemo NullPointerException, nedovoljen tip z izjemo ClassCastException ali nedovoljeno lastnost elementa z izjemo IllegalArgumentException.

List.of(...) ustvari seznam, ki ga ni mogoče spreminjati. Arrays.asList(...) vrne seznam, povezan s tabelo: elemente je mogoče zamenjati, velikost pa je fiksna. Nobeden ne podpira add. Če potrebuješ ločen seznam, ki lahko raste, uporabi new ArrayList<>(source). Dodajanje na konec kopije ne spremeni izvornega seznama.

Primeri

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

Dodajanje drugega `alpha` na konec seznama `tags` vrne `true`. Vstavljanje `gamma` na indeks `1` premakne `beta` in drugi `alpha` v desno. Seznam `source` ostane nespremenjen in zavrne poskus dodajanja `delta`.

Povezane lekcije

  • Java · Lekcija 1 · Napredna · Različica: 2
  • Java · Lekcija 2 · Napredna · Različica: 2
  • Java · Lekcija 6 · Napredna · Različica: 2
  • Java · Lekcija 8 · Napredna · Različica: 2
  • Java · Lekcija 10 · Napredna · Različica: 2
  • Java · Lekcija 13 · Napredna · Različica: 2
  • Java · Lekcija 21 · Napredna · Različica: 2
  • Java · Lekcija 33 · Napredna · Različica: 2
  • Java · Lekcija 35 · Napredna · Različica: 2
  • Java · Lekcija 36 · Napredna · Različica: 2
  • Java · Lekcija 38 · Napredna · Različica: 2
  • Java · Lekcija 19 · Osnovna · Različica: 2
  • Java · Lekcija 29 · Osnovna · Različica: 2
  • Java · Lekcija 39 · Osnovna · Različica: 2
  • Java · Lekcija 44 · Osnovna · Različica: 2
  • Java · Lekcija 54 · Osnovna · Različica: 2
  • Java · Lekcija 57 · Osnovna · Različica: 2
  • Java · Lekcija 59 · Osnovna · Različica: 2
  • Java · Lekcija 62 · Osnovna · Različica: 2
  • Java · Lekcija 2 · Srednja · Različica: 2
  • Java · Lekcija 5 · Srednja · Različica: 2
  • Java · Lekcija 6 · Srednja · Različica: 2
  • Java · Lekcija 33 · Srednja · Različica: 2
  • Java · Lekcija 34 · Srednja · Različica: 2
  • Java · Lekcija 36 · Srednja · Različica: 2
  • Java · Lekcija 39 · Srednja · Različica: 2
  • Java · Lekcija 50 · Srednja · Različica: 2

Viri