Функция elementAt

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

Синтаксис

kotlinfun <T> Iterable<T>.elementAt(index: Int): T
kotlinfun <T> Array<T>.elementAt(index: Int): T
kotlinfun <K, V> Map<out K, V>.elementAt(index: Int): Map.Entry<K, V>

Пример

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

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

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

kotlinChar c

Пример

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

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

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

kotlinInt 4

Пример

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

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

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

kotlinString "banana"

Пример

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

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

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

kotlinMap.Entry (a=1)

Пример

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

kotlinval 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")
}

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

kotlinString "Index 5 out of bounds for length 3"

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

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