Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

List.addAll — přidání na konec nebo vložení prvků

Pomocí `List.addAll` přidáš prvky kolekce na konec seznamu nebo je vložíš na zvolený index. Návratová hodnota typu `boolean` říká, zda se cílový seznam změnil.

Verze: Java SE 21

Syntaxe

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

V Java SE 21 má rozhraní java.util.List<E> dvě přetížené varianty metody List.addAll. List.addAll(Collection) přidá prvky na konec cílového seznamu v pořadí, v jakém je vrací iterátor zdrojové kolekce. Pokud je zdrojem jiný seznam, jeho prvky se v původním pořadí přidají za dosavadní prvky cílového seznamu. Metoda prvky neřadí ani neodstraňuje duplicity. Zápis Collection<? extends E> znamená, že zdroj nemusí být seznam a deklarovaný typ jeho prvků může být E nebo podtyp E.

List.addAll(int, Collection) vkládá prvky od zadaného indexu počítaného od nuly, ve stejném pořadí jako ve zdroji. Dosavadní prvky od místa vložení se posunou doprava. Platné indexy jsou od 0 do size() včetně; size() znamená přidání na konec. Index mimo tento rozsah může vyvolat IndexOutOfBoundsException.

Obě varianty mění seznam, na kterém jsou volány. Vrátí true, pokud se seznam změnil, jinak false. Například přidání prázdné kolekce do ArrayList vrátí false. Výsledkem není nový seznam. Pokud chceš ponechat první seznam beze změny, vytvoř new ArrayList<>(first) a přidej prvky druhého seznamu do této kopie.

Přidávání je volitelná operace: List.of(...) lze použít jako zdroj, ale jako cíl vyvolá UnsupportedOperationException. Pokud cílový seznam operaci nepodporuje, může tuto výjimku vyvolat ještě před kontrolou argumentů. Argument null může vyvolat NullPointerException, stejně jako prvek null, pokud ho cílový seznam nepovoluje. Omezení týkající se třídy prvku nebo jeho jiných vlastností mohou vyvolat ClassCastException, respektive IllegalArgumentException. Během volání zdroj neměň: chování pak není definováno, a to ani tehdy, když je neprázdný seznam sám sobě zdrojem.

Příklady

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()));
    }
}

Výsledek

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

Program vytvoří modifikovatelnou kopii `first`. Přidání `second` na konec vrátí `true` a zachová oba výskyty `B`. Vložení na index `1` umístí `X` a `Y` za `A`. Přidání prázdné kolekce vrátí `false`.

Související lekce

  • Java · Lekce 14 · Pokročilá · Verze: 2
  • Java · Lekce 54 · Základní · Verze: 2

Zdroje