Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

List.add — dodawanie elementu do listy

`List.add(E)` dopisuje jeden element na końcu listy i zwraca `true` po udanym dodaniu. Wariant z indeksem wstawia element na wybranej pozycji.

Wersja: Java SE 21

Składnia

boolean add(E e)
void add(int index, E element)

W Java SE 21 interfejs java.util.List<E> udostępnia dwa przeciążenia List.add. Jednoargumentowa metoda List.add(E) dopisuje element do istniejącej listy. E oznacza typ elementu, na przykład String w List<String>. Metoda zachowuje kolejność dotychczasowych elementów i po udanym dodaniu zwraca true, a nie indeks ani nową listę. ArrayList pozwala dodawać duplikaty i wartości null.

Przeciążenie add(int index, E element) wstawia element na pozycji liczonej od zera i zwraca void. Element na tej pozycji oraz wszystkie następne przesuwają się o jedno miejsce w prawo. index == size() oznacza dopisanie na końcu; indeks spoza zakresu 0 <= index && index <= size() jest nieprawidłowy i powoduje IndexOutOfBoundsException, jeśli wstawianie jest obsługiwane. W odróżnieniu od set(index, element) wstawienie nie zastępuje elementu.

Dodawanie jest operacją opcjonalną: sam typ List<E> nie gwarantuje, że konkretna lista pozwala dodać element. Nieobsługiwana operacja powoduje UnsupportedOperationException, a nie zwrócenie false. Lista, która obsługuje dodawanie, może odrzucić null przez NullPointerException, niedozwolony typ przez ClassCastException lub element o niedozwolonej właściwości przez IllegalArgumentException.

List.of(...) tworzy listę niemodyfikowalną. Arrays.asList(...) zwraca listę powiązaną z tablicą: można zastępować elementy, ale rozmiar jest stały. Żadna z tych list nie obsługuje add. Jeśli potrzebujesz osobnej listy, do której można dodawać elementy, użyj new ArrayList<>(source). Dodanie elementu do kopii nie zmienia listy źródłowej.

Przykłady

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> source = List.of("alpha", "beta");
        List<String> tags = new ArrayList<>(source);

        boolean added = tags.add("alpha");
        tags.add(1, "gamma");

        System.out.println(added);
        System.out.println(tags);
        System.out.println(source);

        try {
            source.add("delta");
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException");
        }
    }
}

Wynik

true
[alpha, gamma, beta, alpha]
[alpha, beta]
UnsupportedOperationException

Dopisanie drugiego `alpha` do `tags` zwraca `true`. Wstawienie `gamma` pod indeksem `1` przesuwa `beta` i drugie `alpha` w prawo. `source` pozostaje bez zmian i odrzuca próbę dodania `delta`.

Powiązane lekcje

  • Java · Lekcja 1 · Zaawansowany · Wersja: 2
  • Java · Lekcja 2 · Zaawansowany · Wersja: 2
  • Java · Lekcja 6 · Zaawansowany · Wersja: 2
  • Java · Lekcja 8 · Zaawansowany · Wersja: 2
  • Java · Lekcja 10 · Zaawansowany · Wersja: 2
  • Java · Lekcja 13 · Zaawansowany · Wersja: 2
  • Java · Lekcja 21 · Zaawansowany · Wersja: 2
  • Java · Lekcja 33 · Zaawansowany · Wersja: 2
  • Java · Lekcja 35 · Zaawansowany · Wersja: 2
  • Java · Lekcja 36 · Zaawansowany · Wersja: 2
  • Java · Lekcja 38 · Zaawansowany · Wersja: 2
  • Java · Lekcja 19 · Podstawowy · Wersja: 2
  • Java · Lekcja 29 · Podstawowy · Wersja: 2
  • Java · Lekcja 39 · Podstawowy · Wersja: 2
  • Java · Lekcja 44 · Podstawowy · Wersja: 2
  • Java · Lekcja 54 · Podstawowy · Wersja: 2
  • Java · Lekcja 57 · Podstawowy · Wersja: 2
  • Java · Lekcja 59 · Podstawowy · Wersja: 2
  • Java · Lekcja 62 · Podstawowy · Wersja: 2
  • Java · Lekcja 2 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 5 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 6 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 33 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 34 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 36 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 39 · Średniozaawansowany · Wersja: 2
  • Java · Lekcja 50 · Średniozaawansowany · Wersja: 2

Źródła