addAll

kotlin-stdlib/kotlin.collections/ArrayDeque/addAll

Начиная с Kotlin: 1.4


@IgnorableReturnValue
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
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
}

© 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-deque/add-all.html