Функция addAll

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

Импорт

kotlinimport kotlin.collections.addAll

Синтаксис

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

Пример

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

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

list1.addAll(list2)
println(list1)

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

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

Пример

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

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

mutableList.addAll(set)
println(mutableList)

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

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

Пример

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

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

mutableSet.addAll(array)
println(mutableSet)

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

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

Пример

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

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

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

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

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

Пример

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

kotlinval 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")

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

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

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

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