CKTIS / Java
List.add(E) — dodawanie elementu na końcu listy
Metoda `List.add(E)` dopisuje jeden element na końcu istniejącej listy i zwraca `true`, jeśli wywołanie kończy się normalnie. Nie każda lista obsługuje dodawanie.
Wersja: Java SE 21
Składnia
boolean add(E e)
boolean added = items.add(element);List.add(E) to jednoargumentowa metoda interfejsu java.util.List<E>. E oznacza typ elementów, na przykład Customer w repozytorium opartym na List<Customer>. Metoda zmienia istniejącą listę: nowy element trafia na koniec, a wcześniejsze elementy zachowują kolejność. Normalne zakończenie oznacza wynik true, a nie indeks ani nową listę.
Lista zapisuje przekazaną referencję, nie kopię obiektu. W ArrayList można dodać tę samą referencję wielokrotnie; zmiana współdzielonego obiektu jest widoczna z każdej pozycji, która na niego wskazuje. Listy zwykle dopuszczają duplikaty, więc kolejne wywołania add nadają się do zapisywania zdarzeń lub odbiorców w kolejności dodawania.
Dodawanie jest operacją opcjonalną: lista z List.of(...) nie pozwala na modyfikacje i zgłasza UnsupportedOperationException. Lista, która obsługuje dodawanie, może mimo to odrzucić element: NullPointerException oznacza niedozwolone null, ClassCastException — niedozwoloną klasę elementu, a IllegalArgumentException — inną niedozwoloną cechę elementu. ArrayList dopuszcza null.
Przeciążenie add(int index, E element) zwraca void i wstawia element pod indeksem od 0 do size() włącznie, przesuwając dalsze elementy. Przy cofaniu usunięcia użyj zapamiętanego indeksu, jeśli trzeba przywrócić pierwotną pozycję; add(element) tylko dopisze element na końcu. Dostępna od Javy 21 metoda addLast(E) również dopisuje na końcu, ale zwraca void.
Przykłady
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<StringBuilder> items = new ArrayList<>();
StringBuilder first = new StringBuilder("Ada");
boolean added = items.add(first);
items.add(new StringBuilder("Lin"));
items.add(first);
System.out.println(added);
System.out.println(items);
System.out.println(items.get(0) == items.get(2));
first.append("!");
System.out.println(items);
}
}Wynik
true [Ada, Lin, Ada] true [Ada!, Lin, Ada!]
Pierwsze `true` to wynik `add`, a drugie — wynik porównania referencji przez `==`. Po zmianie obiektu `first` obie pozycje pokazują `Ada!`, ponieważ wskazują na ten sam obiekt.
Powiązane lekcje
- Java · Lekcja 21 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 22 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 26 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 27 · Średniozaawansowany · Wersja: 2
- Java · Lekcja 32 · Średniozaawansowany · Wersja: 2