Функция toList

Функция toList преобразует исходную коллекцию или массив в неизменяемый список типа List. Применяется к массивам, коллекциям и последовательностям. Возвращает новый список с элементами исходной коллекции в том же порядке.

Синтаксис

fun <T> Array<out T>.toList(): List<T>

fun <T> Iterable<T>.toList(): List<T>

fun <T> Sequence<T>.toList(): List<T>

Пример

Преобразуем массив символов в список:

val arr: Array<Char> = arrayOf('a', 'b', 'c', 'd', 'e')
val res: List<Char> = arr.toList()
println(res)

Результат выполнения кода:

List<Char> ['a', 'b', 'c', 'd', 'e']

Пример

Преобразуем множество в список:

val set: Set<Int> = setOf(1, 2, 3, 4, 5)
val res: List<Int> = set.toList()
println(res)

Результат выполнения кода:

List<Int> [1, 2, 3, 4, 5]

Пример

Преобразуем последовательность в список:

val seq: Sequence<String> = sequenceOf("abc", "def", "ghi")
val res: List<String> = seq.toList()
println(res)

Результат выполнения кода:

List<String> ["abc", "def", "ghi"]

Пример

Результирующий список является неизменяемым:

val arr: Array<Int> = arrayOf(1, 2, 3)
val list: List<Int> = arr.toList()

// Это вызовет ошибку компиляции:
// list.add(4)
// list[0] = 5

Пример

Для получения изменяемого списка используйте функцию toMutableList:

val arr: Array<Int> = arrayOf(1, 2, 3)
val mutableList: MutableList<Int> = arr.toMutableList()
mutableList.add(4)
println(mutableList)

Результат выполнения кода:

MutableList<Int> [1, 2, 3, 4]

Смотрите также

функцию toMutableList,
которая преобразует в изменяемый список
функцию toSet,
которая преобразует в множество
функцию toArray,
которая преобразует в массив
функцию asList,
которая возвращает представление массива в виде списка