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