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