Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

List.addAll — dodavanje na kraj ili umetanje elemenata

Pomoću `List.addAll` možeš dodati elemente kolekcije na kraj liste ili ih umetnuti na odabrani indeks. Rezultat tipa `boolean` govori je li se odredišna lista promijenila.

Verzija: Java SE 21

Sintaksa

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

U Java SE 21 sučelje java.util.List<E> ima dvije preopterećene inačice metode List.addAll. List.addAll(Collection) dodaje elemente na kraj odredišne liste redoslijedom kojim ih vraća iterator izvorne kolekcije. Ako je izvor druga lista, njezini elementi dolaze iza postojećih elemenata odredišne liste i zadržavaju svoj izvorni redoslijed. Metoda ne sortira elemente niti uklanja duplikate. Collection<? extends E> znači da izvor ne mora biti lista, a deklarirani tip njegovih elemenata može biti E ili podtip tipa E.

List.addAll(int, Collection) umeće elemente od zadanog indeksa, pri čemu indeksi počinju od nule, a redoslijed iz izvora ostaje isti. Postojeći elementi od mjesta umetanja pomiču se udesno. Valjani su indeksi od 0 do size(), uključivo; size() znači dodavanje na kraj. Indeks izvan tog raspona može izazvati IndexOutOfBoundsException.

Obje inačice mijenjaju listu na kojoj ih pozoveš. Vraćaju true ako se lista promijenila, inače false. Na primjer, dodavanje prazne kolekcije u ArrayList vraća false. Rezultat nije nova lista. Ako želiš zadržati prvu listu nepromijenjenom, stvori new ArrayList<>(first) pa toj kopiji dodaj elemente druge liste.

Dodavanje je neobavezna operacija: List.of(...) može poslužiti kao izvor, ali kao odredište baca UnsupportedOperationException. Ako odredišna lista ne podržava operaciju, može baciti tu iznimku prije provjere argumenata. Argument null može izazvati NullPointerException, kao i element null ako ga odredište ne dopušta. Ograničenja vezana uz klasu elementa ili njegova druga svojstva mogu izazvati ClassCastException odnosno IllegalArgumentException. Nemoj mijenjati izvor tijekom poziva: ponašanje je tada nedefinirano, pa i kada je neprazna lista sama sebi izvor.

Primjeri

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 stvara promjenjivu kopiju liste `first`. Dodavanje liste `second` na kraj vraća `true` i zadržava oba pojavljivanja elementa `B`. Umetanje na indeks `1` stavlja `X` i `Y` iza `A`. Dodavanje prazne kolekcije vraća `false`.

Povezane lekcije

  • Java · Lekcija 14 · Napredno · Verzija: 2
  • Java · Lekcija 54 · Osnovno · Verzija: 2

Izvori