CKTIS / Java
List.addAll — dopisywanie i wstawianie elementów
Użyj `List.addAll`, aby dopisać elementy kolekcji na końcu listy albo wstawić je pod wybranym indeksem. Wynik typu `boolean` informuje, czy lista docelowa się zmieniła.
Wersja: Java SE 21
Składnia
boolean addAll(Collection<? extends E> c)
boolean addAll(int index, Collection<? extends E> c)W Java SE 21 interfejs java.util.List<E> udostępnia dwa przeciążenia List.addAll. List.addAll(Collection) dopisuje elementy na końcu listy docelowej w kolejności zwracanej przez iterator kolekcji źródłowej. Jeśli źródłem jest druga lista, jej elementy pojawią się za dotychczasowymi elementami listy docelowej, w tej samej kolejności. Metoda nie sortuje elementów ani nie usuwa duplikatów. Zapis Collection<? extends E> oznacza, że źródłem nie musi być lista, a zadeklarowany typ jej elementów może być E lub podtypem E.
List.addAll(int, Collection) wstawia elementy od indeksu liczonego od zera, zachowując tę samą kolejność źródłową. Dotychczasowe elementy od miejsca wstawienia przesuwają się w prawo. Dozwolone indeksy to od 0 do size() włącznie; size() oznacza dopisanie na końcu. Indeks spoza zakresu może spowodować IndexOutOfBoundsException.
Oba przeciążenia modyfikują listę, na której je wywołano. Zwracają true, jeśli lista się zmieniła, i false, jeśli się nie zmieniła. Na przykład dodanie pustej kolekcji do ArrayList zwraca false. Wynikiem nie jest nowa lista. Aby zachować pierwszą listę bez zmian, utwórz new ArrayList<>(first) i dopiero do tej kopii dodaj elementy drugiej listy.
Dodawanie jest operacją opcjonalną: List.of(...) może być źródłem, ale jako lista docelowa zgłosi UnsupportedOperationException. Jeśli lista docelowa nie obsługuje operacji, może zgłosić ten wyjątek przed sprawdzeniem argumentów. Argument null może spowodować NullPointerException, podobnie jak element null, jeśli lista docelowa go nie dopuszcza. Ograniczenia dotyczące klasy lub innych właściwości elementu mogą skutkować odpowiednio ClassCastException lub IllegalArgumentException. Nie modyfikuj źródła w trakcie wywołania: zachowanie jest wtedy niezdefiniowane, także gdy niepusta lista jest własnym źródłem.
Przykłady
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()));
}
}Wynik
true [A, B, B, C] [A, X, Y, B, B, C] false
Program tworzy modyfikowalną kopię `first`. Dopisanie `second` zwraca `true` i zachowuje oba wystąpienia `B`, wstawienie pod indeksem `1` umieszcza `X` i `Y` za `A`, a dodanie pustej kolekcji zwraca `false`.
Powiązane lekcje
- Java · Lekcja 14 · Zaawansowany · Wersja: 2
- Java · Lekcja 54 · Podstawowy · Wersja: 2