Справочник Java

List.add()

Добавляет элемент в конец списка или в указанную позицию.

Доступно с: Java 1.2

Синтаксис

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

Параметры

Параметр	Тип	Описание
index	int	Необязательная позиция вставки; элементы с этой позиции сдвигаются вправо.
e	E	Добавляемый элемент.

Возвращаемое значение

booleanВерсия без индекса возвращает `true`; версия с индексом ничего не возвращает.

Примеры

Добавление в конец:

void main() {
    List<String> fruits = new ArrayList<>();
    fruits.add("apple");
    fruits.add("pear");
    IO.println(fruits);
}

Результат:

[apple, pear]

Вставка по индексу:

void main() {
    List<String> fruits = new ArrayList<>(List.of("apple", "pear"));
    fruits.add(0, "kiwi");
    fruits.add(2, "plum");
    IO.println(fruits);
}

Результат:

[kiwi, apple, plum, pear]

Примечания

Индекс может быть от 0 до size() включительно: add(size(), x) — то же самое, что add(x). Больший индекс бросает IndexOutOfBoundsException. Неизменяемые списки (List.of()) бросают UnsupportedOperationException.

См. также

List.addAll() — Добавляет в список все элементы другой коллекции.
List.set() — Заменяет элемент списка по индексу.
List.remove() — Удаляет элемент списка по индексу или по значению.
ArrayList — Изменяемый список на основе массива — самая частая реализация `List`.

Вопросы и ответы по теме

В учебнике

Списки: List и ArrayList — Списки в Java: ArrayList, добавление, чтение и удаление элементов, неизменяемые списки List.of и списки чисел.

Спасибо, что читаете!