buildList

Начиная с Kotlin: 1.6

inline fun <E> buildList(builderAction: MutableList<E>.() -> Unit): List<E>

Создаёт новый список List только для чтения, заполняя MutableList с помощью указанного builderAction и возвращая список только для чтения с теми же элементами.

Список, переданный в качестве получателя в builderAction, действителен только внутри этой функции. Использование этого списка за пределами функции приводит к неопределённому поведению.

Возвращаемый список сериализуем (JVM).

Примеры

fun main() { 
   //sampleStart 
   val x = listOf('b', 'c')

val y = buildList {
    add('a')
    addAll(x)
    add('d')
}

println(y) // [a, b, c, d] 
   //sampleEnd
}

inline fun <E> buildList(capacity: Int, builderAction: MutableList<E>.() -> Unit): List<E>

Создаёт новый список List только для чтения, заполняя MutableList с помощью указанного builderAction и возвращая список только для чтения с теми же элементами.

Список, переданный в качестве получателя в builderAction, действителен только внутри этой функции. Использование этого списка за пределами функции приводит к неопределённому поведению.

Возвращаемый список сериализуем (JVM).

capacity используется для указания ожидаемого количества элементов, добавляемых в builderAction.

Исключения

Примеры

fun main() { 
   //sampleStart 
   val x = listOf('b', 'c')

val y = buildList(x.size + 2) {
    add('a')
    addAll(x)
    add('d')
}

println(y) // [a, b, c, d] 
   //sampleEnd
}