Функция toList

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

Синтаксис

kotlinfun <T> Array<out T>.toList(): List<T>
kotlinfun <T> Iterable<T>.toList(): List<T>
kotlinfun <T> Sequence<T>.toList(): List<T>

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

Пример

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

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

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

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

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

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