add

kotlin-stdlib/kotlin.collections/MutableList/add

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


@IgnorableReturnValue
expect abstract 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 abstract 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/-mutable-list/add.html