База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

List.add(E) — добавяне на елемент в края на списък

`List.add(E)` добавя един елемент в края на съществуващия списък и връща `true`, ако извикването завърши нормално. Не всеки списък поддържа добавяне.

Версия: Java SE 21

Синтаксис

boolean add(E e)

boolean added = items.add(element);

List.add(E) е методът с един аргумент на интерфейса java.util.List<E>. E е типът на елементите, например Customer в хранилище, което използва List<Customer>. Методът променя съществуващия списък: новият елемент отива в края, а предишните запазват реда си. При нормално завършване методът връща true, а не индекс или нов списък.

Списъкът съхранява подадената референция, а не копие на обекта. ArrayList може да съхранява една и съща референция повече от веднъж; промените в споделения обект се виждат на всяка позиция, която сочи към него. Списъците обикновено допускат дубликати, затова с последователни извиквания на add можеш да записваш събития или получатели в реда на добавяне.

Добавянето в края е незадължителна операция: списък, създаден с List.of(...), не може да се променя и извикването хвърля UnsupportedOperationException. Дори списък, който поддържа добавяне, може да отхвърли елемент: с NullPointerException при недопустимо null, с ClassCastException при недопустим клас на елемента или с IllegalArgumentException при друго недопустимо свойство на елемента. ArrayList допуска null.

Претовареният метод add(int index, E element) връща void и вмъква елемент на индекс от 0 до size() включително, като измества елементите от тази позиция нататък. За да отмениш премахване и да възстановиш първоначалната позиция, използвай запазения индекс; add(element) добавя само в края. От Java 21 addLast(E) също добавя в края, но връща void.

Примери

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);
    }
}

Резултат

true
[Ada, Lin, Ada]
true
[Ada!, Lin, Ada!]

Първото `true` е резултатът от `add`, а второто е резултатът от сравнението на референциите с `==`. След промяната на обекта `first` и на двете позиции се извежда `Ada!`, защото сочат към един и същ обект.

Свързани уроци

  • Java · Урок 21 · Средно · Версия: 2
  • Java · Урок 22 · Средно · Версия: 2
  • Java · Урок 26 · Средно · Версия: 2
  • Java · Урок 27 · Средно · Версия: 2
  • Java · Урок 32 · Средно · Версия: 2

Източници