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

CKTIS / Java

List.addAll — dodajanje na konec ali vstavljanje elementov

Z metodo `List.addAll` dodaš elemente zbirke na konec seznama ali jih vstaviš na izbrani indeks. Rezultat tipa `boolean` pove, ali se je ciljni seznam spremenil.

Različica: Java SE 21

Sintaksa

boolean addAll(Collection<? extends E> c)
boolean addAll(int index, Collection<? extends E> c)

V Java SE 21 ima vmesnik java.util.List<E> dve preobremenjeni različici metode List.addAll. List.addAll(Collection) doda elemente na konec ciljnega seznama v vrstnem redu, v katerem jih vrne iterator izvorne zbirke. Če je vir drug seznam, se njegovi elementi v prvotnem vrstnem redu dodajo za obstoječe elemente ciljnega seznama. Metoda ne razvršča in ne odstranjuje dvojnikov. Collection<? extends E> pomeni, da vir ni nujno seznam in da je deklarirani tip njegovih elementov lahko E ali podtip tipa E.

List.addAll(int, Collection) vstavi elemente od izbranega indeksa, pri čemer se indeksi štejejo od nič, vrstni red pa ostane enak kot v viru. Obstoječi elementi od mesta vstavljanja naprej se premaknejo v desno. Veljavni indeksi segajo od 0 do vključno size(); size() pomeni dodajanje na konec. Indeks zunaj tega obsega lahko povzroči IndexOutOfBoundsException.

Obe različici spremenita seznam, na katerem ju pokličeš. Vrneta true, če se je seznam spremenil, sicer false. Če na primer v ArrayList dodaš prazno zbirko, dobiš false. Rezultat ni nov seznam. Da prvi seznam ostane nespremenjen, ustvari new ArrayList<>(first) in elemente drugega seznama dodaj tej kopiji.

Dodajanje je neobvezna operacija: List.of(...) lahko uporabiš kot vir, kot cilj pa sproži UnsupportedOperationException. Če ciljni seznam operacije ne podpira, lahko to izjemo sproži, še preden preveri argumente. Argument null lahko povzroči NullPointerException, prav tako element null, če ga ciljni seznam ne dovoljuje. Omejitve glede razreda elementa ali drugih njegovih lastnosti lahko povzročijo ClassCastException oziroma IllegalArgumentException. Vira med klicem ne spreminjaj: vedenje takrat ni določeno, tudi če je neprazen seznam sam sebi vir.

Primeri

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> first = List.of("A", "B");
        List<String> second = List.of("B", "C");
        List<String> result = new ArrayList<>(first);

        System.out.println(result.addAll(second));
        System.out.println(result);

        result.addAll(1, List.of("X", "Y"));
        System.out.println(result);
        System.out.println(result.addAll(List.of()));
    }
}

Rezultat

true
[A, B, B, C]
[A, X, Y, B, B, C]
false

Program ustvari spremenljivo kopijo seznama `first`. Dodajanje seznama `second` na konec vrne `true` in ohrani obe pojavitvi `B`. Vstavljanje na indeks `1` postavi `X` in `Y` za `A`. Dodajanje prazne zbirke vrne `false`.

Povezane lekcije

  • Java · Lekcija 14 · Napredna · Različica: 2
  • Java · Lekcija 54 · Osnovna · Različica: 2

Viri