addAll

kotlin-stdlib/kotlin.collections/MutableList/addAll

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)


@IgnorableReturnValue
expect abstract override fun addAll(elements: Collection<E>): Boolean

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

Элементы добавляются в порядке их следования в коллекции elements.

Возвращает

true, если список был изменён в результате операции.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = mutableListOf('a', 'b', 'c')
println("list.addAll(listOf('a', 'b', 'c')) is ${list.addAll(listOf('a', 'b', 'c'))}") // true
println(list) // [a, b, c, a, b, c] 
   //sampleEnd
}


@IgnorableReturnValue
expect abstract fun addAll(index: Int, elements: Collection<E>): Boolean

Вставляет все элементы указанной коллекции elements в этот список по указанному index.

Элементы вставляются в порядке их следования в коллекции elements.

Все элементы, изначально находившиеся по индексам index .. index + size - 1, сдвигаются на elements.size позиций к концу.

Если index равен size, elements будут добавлены в конец списка.

Возвращает

true, если список был изменён в результате операции.

Выбрасывает

IndexOutOfBoundsException

если index меньше нуля или больше size этого списка.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = mutableListOf('a', 'b', 'c')

list.addAll(1, listOf('x', 'y', 'z'))
println(list) // [a, x, y, z, b, c]

list.addAll(6, listOf('h', 'i'))
println(list) // [a, x, y, z, b, c, h, i]

// list.addAll(100500, listOf('z')) // will fail with IndexOutOfBoundsException 
   //sampleEnd
}

Требования к платформе и версии: JVM (1.0)


@IgnorableReturnValue
actual abstract override fun addAll(elements: Collection<E>): Boolean

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

Элементы добавляются в порядке их следования в коллекции elements.

Возвращает

true, если список был изменён в результате операции.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = mutableListOf('a', 'b', 'c')
println("list.addAll(listOf('a', 'b', 'c')) is ${list.addAll(listOf('a', 'b', 'c'))}") // true
println(list) // [a, b, c, a, b, c] 
   //sampleEnd
}


@IgnorableReturnValue
actual abstract fun addAll(index: Int, elements: Collection<E>): Boolean

Вставляет все элементы указанной коллекции elements в этот список по указанному index.

Элементы вставляются в порядке их следования в коллекции elements.

Все элементы, изначально находившиеся по индексам index .. index + size - 1, сдвигаются на elements.size позиций вправо.

Если index равен size, elements будут добавлены в конец списка.

Возвращает

true, если список был изменён в результате операции.

Выбрасывает

IndexOutOfBoundsException

если index меньше нуля или больше size этого списка.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = mutableListOf('a', 'b', 'c')

list.addAll(1, listOf('x', 'y', 'z'))
println(list) // [a, x, y, z, b, c]

list.addAll(6, listOf('h', 'i'))
println(list) // [a, x, y, z, b, c, h, i]

// list.addAll(100500, listOf('z')) // will fail with IndexOutOfBoundsException 
   //sampleEnd
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/add-all.html