addAll

kotlin-stdlib/kotlin.collections/ArrayList/addAll

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


@IgnorableReturnValue
expect open 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 open override 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
}

Платформа и требования к версии: JS (1.1)


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

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

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

true, если в коллекцию был добавлен хотя бы один из указанных элементов, false, если коллекция не была изменена.

Примеры

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
}

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

fun main() { 
   //sampleStart 
   val set = mutableSetOf('a', 'b', 'c')
// All three elements are in set, nothing will be added
println("set.addAll(listOf('a', 'b', 'c')) is ${set.addAll(listOf('a', 'b', 'c'))}") // false
// At least one element will be added, 'd'
println("set.addAll(listOf('a', 'b', 'c', 'd')) is ${set.addAll(listOf('a', 'b', 'c', 'd'))}") // true
println(set) // [a, b, c, d] 
   //sampleEnd
}


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

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

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

Если 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/-array-list/add-all.html