add

kotlin-stdlib/kotlin.collections/ArrayList/add

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


@IgnorableReturnValue
expect open override fun add(element: E): Boolean

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

Возвращает

true, поскольку в результате этой операции список всегда изменяется.

Примеры

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

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

expect open override fun add(index: Int, element: E)

Вставляет элемент в список по указанному индексу.

Все элементы с индексами index .. index + size - 1 сдвигаются на одну позицию вправо.

Если индекс равен размеру, элемент будет добавлен в конец этого списка.

Исключения

IndexOutOfBoundsException

если индекс меньше нуля или больше размера этого списка.

Примеры

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

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

list.add(1, 'c')
println(list) // [a, c, b, c]

list.add(4, 'a')
println(list) // [a, c, b, c, a]

// list.add(100500, 'a') // will fail with IndexOutOfBoundsException 
   //sampleEnd
}

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


@IgnorableReturnValue
actual open override fun add(element: E): Boolean

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

Возвращает

true, поскольку в результате этой операции список всегда изменяется.

actual open override fun add(index: Int, element: E)

Вставляет элемент в список по указанному индексу.

Все элементы с индексами index .. index + size - 1 сдвигаются на одну позицию вправо.

Если индекс равен размеру, элемент будет добавлен в конец этого списка.

Исключения

IndexOutOfBoundsException

если индекс меньше нуля или больше размера этого списка.

Примеры

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

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

list.add(1, 'c')
println(list) // [a, c, b, c]

list.add(4, 'a')
println(list) // [a, c, b, c, a]

// list.add(100500, 'a') // 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.html