CKTIS / Java
List.addAll — pridanie na koniec alebo vloženie prvkov
Pomocou `List.addAll` pridáš prvky kolekcie na koniec zoznamu alebo ich vložíš na zvolený index. Návratová hodnota typu `boolean` informuje, či sa cieľový zoznam zmenil.
Verzia: Java SE 21
Syntax
boolean addAll(Collection<? extends E> c)
boolean addAll(int index, Collection<? extends E> c)V Java SE 21 má rozhranie java.util.List<E> dve preťažené podoby metódy List.addAll. List.addAll(Collection) pridá prvky na koniec cieľového zoznamu v poradí, v akom ich vracia iterátor zdrojovej kolekcie. Ak je zdrojom iný zoznam, jeho prvky nasledujú za existujúcimi prvkami cieľového zoznamu a zachovajú si pôvodné poradie. Metóda prvky netriedi ani neodstraňuje duplicity. Zápis Collection<? extends E> znamená, že zdroj nemusí byť zoznam a deklarovaný typ jeho prvkov môže byť E alebo podtyp E.
List.addAll(int, Collection) vkladá prvky od zadaného indexu počítaného od nuly, v rovnakom poradí ako v zdroji. Existujúce prvky od miesta vloženia sa posunú doprava. Platné indexy sú od 0 do size() vrátane; size() znamená pridanie na koniec. Index mimo tohto rozsahu môže vyvolať IndexOutOfBoundsException.
Obe podoby menia zoznam, na ktorom ich zavoláš. Vrátia true, ak sa zoznam zmenil, inak false. Napríklad pridanie prázdnej kolekcie do ArrayList vráti false. Výsledkom nie je nový zoznam. Ak chceš ponechať prvý zoznam bez zmeny, vytvor new ArrayList<>(first) a pridaj prvky druhého zoznamu do tejto kópie.
Pridávanie je voliteľná operácia: List.of(...) možno použiť ako zdroj, ale ako cieľ vyvolá UnsupportedOperationException. Ak cieľový zoznam operáciu nepodporuje, môže túto výnimku vyvolať ešte pred kontrolou argumentov. Argument null môže vyvolať NullPointerException, rovnako ako prvok null, ak ho cieľový zoznam nepovoľuje. Obmedzenia týkajúce sa triedy prvku alebo jeho iných vlastností môžu vyvolať ClassCastException, respektíve IllegalArgumentException. Počas volania zdroj nemeň: správanie vtedy nie je definované, a to ani v prípade, že neprázdny zoznam je sám sebe zdrojom.
Prí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ýsledok
true [A, B, B, C] [A, X, Y, B, B, C] false
Program vytvorí modifikovateľnú kópiu `first`. Pridanie `second` na koniec vráti `true` a zachová oba výskyty `B`. Vloženie na index `1` umiestni `X` a `Y` za `A`. Pridanie prázdnej kolekcie vráti `false`.
Súvisiace lekcie
- Java · Lekcia 14 · Pokročilá · Verzia: 2
- Java · Lekcia 54 · Základná · Verzia: 2