Функция asList

Функция asList преобразует массив или диапазон в неизменяемый список типа List. Применяется к массивам различных типов и возвращает представление массива в виде списка.

Импорт

import kotlin.collections.asList

Синтаксис

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

fun IntArray.asList(): List<Int>

fun LongArray.asList(): List<Long>

fun DoubleArray.asList(): List<Double>

fun FloatArray.asList(): List<Float>

fun ShortArray.asList(): List<Short>

fun ByteArray.asList(): List<Byte>

fun CharArray.asList(): List<Char>

fun BooleanArray.asList(): List<Boolean>

Пример

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

val numbers = intArrayOf(1, 2, 3, 4, 5)
val list = numbers.asList()
println(list)

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

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

Пример

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

val strings = arrayOf("a", "b", "c", "d", "e")
val list = strings.asList()
println(list)

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

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

Пример

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

val chars = charArrayOf('a', 'b', 'c', 'd', 'e')
val list = chars.asList()
println(list)

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

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

Пример

Полученный список является неизменяемым. Попытка изменить его элементы приведет к исключению:

val numbers = intArrayOf(1, 2, 3, 4, 5)
val list = numbers.asList()

try {
	list[0] = 10
} catch (e: UnsupportedOperationException) {
	println("Cannot modify read-only list")
}

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

Cannot modify read-only list

Пример

Изменения в исходном массиве отражаются в полученном списке, так как список является представлением массива:

val numbers = intArrayOf(1, 2, 3, 4, 5)
val list = numbers.asList()

numbers[0] = 100
println(list)

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

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

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

функцию toList,
которая создает новый список из элементов
функцию toMutableList,
которая создает изменяемый список
функцию toArray,
которая преобразует коллекцию в массив
функцию asSequence,
которая преобразует коллекцию в последовательность