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