CKTIS / Java
List.addAll — добавяне в края или вмъкване на елементи
Използвай `List.addAll`, за да добавиш елементите на колекция в края на списък или да ги вмъкнеш на избран индекс. Резултатът от тип `boolean` показва дали целевият списък се е променил.
Версия: Java SE 21
Синтаксис
boolean addAll(Collection<? extends E> c)
boolean addAll(int index, Collection<? extends E> c)В Java SE 21 интерфейсът java.util.List<E> предлага два претоварени варианта на List.addAll. List.addAll(Collection) добавя елементите в края на целевия списък в реда, в който ги връща итераторът на изходната колекция. Ако източникът е друг списък, елементите му се нареждат след наличните елементи на целевия списък в първоначалния си ред. Методът не сортира елементите и не премахва дубликати. Collection<? extends E> означава, че източникът не е задължително списък, а декларираният тип на елементите му може да бъде E или подтип на E.
List.addAll(int, Collection) вмъква елементите от зададен индекс, броен от нула, като запазва същия ред от източника. Наличните елементи от позицията на вмъкване нататък се изместват надясно. Допустимите индекси са от 0 до size() включително; size() означава добавяне в края. Индекс извън този диапазон може да доведе до IndexOutOfBoundsException.
И двата варианта променят списъка, върху който са извикани. Връщат true, ако списъкът се е променил, и false, ако не се е променил. Например добавянето на празна колекция към ArrayList връща false. Резултатът не е нов списък. За да запазиш първия списък непроменен, създай new ArrayList<>(first) и добави елементите на втория списък към това копие.
Добавянето е незадължителна операция: List.of(...) може да служи като източник, но като цел хвърля UnsupportedOperationException. Ако целевият списък не поддържа операцията, той може да хвърли това изключение, преди да провери аргументите. Аргумент null може да доведе до NullPointerException, както и елемент null, ако целевият списък не го допуска. Ограниченията за класа или за други свойства на даден елемент могат да доведат съответно до ClassCastException или IllegalArgumentException. Не променяй източника по време на извикването: поведението тогава е неопределено, включително когато непразен списък е източник за самия себе си.
Примери
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()));
}
}Резултат
true [A, B, B, C] [A, X, Y, B, B, C] false
Програмата създава изменяемо копие на `first`. Добавянето на `second` в края връща `true` и запазва и двете срещания на `B`. Вмъкването на индекс `1` поставя `X` и `Y` след `A`. Добавянето на празна колекция връща `false`.
Свързани уроци
- Java · Урок 14 · Напреднало · Версия: 2
- Java · Урок 54 · Начално · Версия: 2