Функция elementAt

Функция elementAt возвращает элемент коллекции по указанному индексу. Работает с различными типами коллекций: Array, List, Set, Map и другими. Для Map функция возвращает пару ключ-значение по указанному индексу. В первый параметр передается индекс элемента, который нужно получить.

Синтаксис

fun <T> Iterable<T>.elementAt(index: Int): T

fun <T> Array<T>.elementAt(index: Int): T

fun <K, V> Map<out K, V>.elementAt(index: Int): Map.Entry<K, V>

Пример

Получим элемент по индексу из массива:

val arr = arrayOf('a', 'b', 'c', 'd', 'e')
val res = arr.elementAt(2)
println(res)

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

Char c

Пример

Получим элемент по индексу из списка:

val list = listOf(1, 2, 3, 4, 5)
val res = list.elementAt(3)
println(res)

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

Int 4

Пример

Получим элемент по индексу из множества:

val set = setOf("apple", "banana", "cherry")
val res = set.elementAt(1)
println(res)

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

String "banana"

Пример

Получим элемент по индексу из словаря:

val map = mapOf("a" to 1, "b" to 2, "c" to 3)
val res = map.elementAt(0)
println(res)

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

Map.Entry (a=1)

Пример

При попытке получить элемент по несуществующему индексу функция elementAt выбрасывает исключение:

val arr = arrayOf('a', 'b', 'c')

try {
	val res = arr.elementAt(5)
	println(res)
} catch (e: IndexOutOfBoundsException) {
	println("Index 5 out of bounds for length 3")
}

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

String "Index 5 out of bounds for length 3"

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

функцию elementAtOrElse,
которая возвращает значение по умолчанию для несуществующих индексов
функцию elementAtOrNull,
которая возвращает null для несуществующих индексов
функцию get,
которая является синонимом для elementAt
функцию first,
которая возвращает первый элемент коллекции