Функция addAll

Функция addAll добавляет все элементы из переданной коллекции в текущую изменяемую коллекцию. Функция работает с различными типами коллекций: MutableList, MutableSet, MutableCollection. В первый параметр передается коллекция элементов для добавления, во второй необязательный параметр можно передать индекс позиции для вставки (только для списков).

Импорт

import kotlin.collections.addAll

Синтаксис

fun <T> MutableCollection<in T>.addAll(elements: Collection<T>): Boolean

fun <T> MutableList<in T>.addAll(index: Int, elements: Collection<T>): Boolean

Пример

Добавим все элементы из одного списка в другой:

val list1 = mutableListOf(1, 2, 3)
val list2 = listOf(4, 5, 6)

list1.addAll(list2)
println(list1)

Результат выполнения кода:

MutableList [1, 2, 3, 4, 5, 6]

Пример

Добавим все элементы из множества в изменяемый список:

val mutableList = mutableListOf('a', 'b', 'c')
val set = setOf('d', 'e', 'f')

mutableList.addAll(set)
println(mutableList)

Результат выполнения кода:

MutableList ['a', 'b', 'c', 'd', 'e', 'f']

Пример

Добавим элементы массива в изменяемое множество:

val mutableSet = mutableSetOf(1, 2, 3)
val array = arrayOf(3, 4, 5)

mutableSet.addAll(array)
println(mutableSet)

Результат выполнения кода:

MutableSet [1, 2, 3, 4, 5]

Пример

Добавим элементы в определенную позицию списка:

val numbers = mutableListOf(1, 2, 5, 6)
val toInsert = listOf(3, 4)

numbers.addAll(2, toInsert)
println(numbers)

Результат выполнения кода:

MutableList [1, 2, 3, 4, 5, 6]

Пример

Функция addAll возвращает true, если коллекция была изменена в результате операции:

val list = mutableListOf(1, 2, 3)
val emptyList = emptyList<Int>()

val res1 = list.addAll(listOf(4, 5))
val res2 = list.addAll(emptyList)

println("First addAll result: $res1")
println("Second addAll result: $res2")
println("Final list: $list")

Результат выполнения кода:

First addAll result: true
Second addAll result: false
Final list: [1, 2, 3, 4, 5]

Смотрите также

функцию removeAll,
которая удаляет все элементы из коллекции
функцию retainAll,
которая оставляет только указанные элементы в коллекции
функцию plusElement,
которая добавляет один элемент в коллекцию