Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła