CKTIS / Java
List.add — добавяне на елемент в списък
`List.add(E)` добавя един елемент в края на списък и при успех връща `true`. Претовареният вариант с индекс вмъква елемент на избрана позиция.
Версия: Java SE 21
Синтаксис
boolean add(E e)
void add(int index, E element)В Java SE 21 интерфейсът java.util.List<E> предоставя два претоварени варианта на List.add. Методът с един аргумент, List.add(E), добавя елемент в края на съществуващия списък. E означава типа на елементите, например String в List<String>. Методът запазва реда на наличните елементи и при успех връща true, а не индекс или нов списък. ArrayList допуска повтарящи се елементи и стойности null.
Вариантът add(int index, E element) вмъква елемент на позиция, номерирана от нула, и има тип на връщане void. Елементът на тази позиция и всички следващи се изместват с едно място надясно. При index == size() елементът се добавя в края. Индекс извън диапазона 0 <= index && index <= size() е невалиден и предизвиква IndexOutOfBoundsException, ако вмъкването се поддържа. За разлика от set(index, element), вмъкването не заменя елемент.
Добавянето е незадължителна операция: само типът List<E> не гарантира, че конкретният списък позволява добавяне. Неподдържаното извикване хвърля UnsupportedOperationException, вместо да върне false. Списък, който поддържа добавяне, все пак може да отхвърли null с NullPointerException, недопустим тип с ClassCastException или недопустимо свойство на елемента с IllegalArgumentException.
List.of(...) създава списък, който не може да се променя. Arrays.asList(...) връща списък, свързан с масив: елементите могат да се заменят, но размерът е фиксиран. Нито един от двата не поддържа add. Ако ти трябва отделен списък, който може да расте, използвай new ArrayList<>(source). Добавянето в края на копието не променя изходния списък.
Примери
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");
}
}
}Резултат
true [alpha, gamma, beta, alpha] [alpha, beta] UnsupportedOperationException
Добавянето на втори елемент `alpha` в края на `tags` връща `true`. Вмъкването на `gamma` на индекс `1` измества `beta` и втория `alpha` надясно. `source` остава непроменен и отхвърля опита за добавяне на `delta`.
Свързани уроци
- Java · Урок 1 · Напреднало · Версия: 2
- Java · Урок 2 · Напреднало · Версия: 2
- Java · Урок 6 · Напреднало · Версия: 2
- Java · Урок 8 · Напреднало · Версия: 2
- Java · Урок 10 · Напреднало · Версия: 2
- Java · Урок 13 · Напреднало · Версия: 2
- Java · Урок 21 · Напреднало · Версия: 2
- Java · Урок 33 · Напреднало · Версия: 2
- Java · Урок 35 · Напреднало · Версия: 2
- Java · Урок 36 · Напреднало · Версия: 2
- Java · Урок 38 · Напреднало · Версия: 2
- Java · Урок 19 · Начално · Версия: 2
- Java · Урок 29 · Начално · Версия: 2
- Java · Урок 39 · Начално · Версия: 2
- Java · Урок 44 · Начално · Версия: 2
- Java · Урок 54 · Начално · Версия: 2
- Java · Урок 57 · Начално · Версия: 2
- Java · Урок 59 · Начално · Версия: 2
- Java · Урок 62 · Начално · Версия: 2
- Java · Урок 2 · Средно · Версия: 2
- Java · Урок 5 · Средно · Версия: 2
- Java · Урок 6 · Средно · Версия: 2
- Java · Урок 33 · Средно · Версия: 2
- Java · Урок 34 · Средно · Версия: 2
- Java · Урок 36 · Средно · Версия: 2
- Java · Урок 39 · Средно · Версия: 2
- Java · Урок 50 · Средно · Версия: 2