kotlin-stdlib / kotlin.collections / elementAt

elementAt

Common
JVM
JS
Native
1.0
fun <T> Array<out T>.elementAt(index: Int): T
(Common source) (JVM source) (JS source) (Native source)

Returns an element at the given index or throws an IndexOutOfBoundsException if the index is out of bounds of this array.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3)
println(list.elementAt(0)) // 1
println(list.elementAt(2)) // 3
// list.elementAt(3) // will fail with IndexOutOfBoundsException

val emptyList = emptyList<Int>()
// emptyList.elementAt(0) // will fail with IndexOutOfBoundsException
//sampleEnd
}
Common
JVM
JS
Native
1.0
fun <T> Iterable<T>.elementAt(index: Int): T
(source)

Returns an element at the given index or throws an IndexOutOfBoundsException if the index is out of bounds of this collection.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3)
println(list.elementAt(0)) // 1
println(list.elementAt(2)) // 3
// list.elementAt(3) // will fail with IndexOutOfBoundsException

val emptyList = emptyList<Int>()
// emptyList.elementAt(0) // will fail with IndexOutOfBoundsException
//sampleEnd
}
Common
JVM
JS
Native
1.0
fun <T> List<T>.elementAt(index: Int): T
(source)

Returns an element at the given index or throws an IndexOutOfBoundsException if the index is out of bounds of this list.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3)
println(list.elementAt(0)) // 1
println(list.elementAt(2)) // 3
// list.elementAt(3) // will fail with IndexOutOfBoundsException

val emptyList = emptyList<Int>()
// emptyList.elementAt(0) // will fail with IndexOutOfBoundsException
//sampleEnd
}
Common
JVM
Native
1.3
@ExperimentalUnsignedTypes fun UIntArray.elementAt(
    index: Int
): UInt
(Common source) (JVM source) (Native source)
@ExperimentalUnsignedTypes fun ULongArray.elementAt(
    index: Int
): ULong
(Common source) (JVM source) (Native source)
@ExperimentalUnsignedTypes fun UByteArray.elementAt(
    index: Int
): UByte
(Common source) (JVM source) (Native source)
@ExperimentalUnsignedTypes fun UShortArray.elementAt(
    index: Int
): UShort
(Common source) (JVM source) (Native source)

Returns an element at the given index or throws an IndexOutOfBoundsException if the index is out of bounds of this array.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3)
println(list.elementAt(0)) // 1
println(list.elementAt(2)) // 3
// list.elementAt(3) // will fail with IndexOutOfBoundsException

val emptyList = emptyList<Int>()
// emptyList.elementAt(0) // will fail with IndexOutOfBoundsException
//sampleEnd
}
JS
1.3
fun <ERROR CLASS>.elementAt(index: Int): <ERROR CLASS>
(source)

Returns an element at the given index or throws an IndexOutOfBoundsException if the index is out of bounds of this array.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3)
println(list.elementAt(0)) // 1
println(list.elementAt(2)) // 3
// list.elementAt(3) // will fail with IndexOutOfBoundsException

val emptyList = emptyList<Int>()
// emptyList.elementAt(0) // will fail with IndexOutOfBoundsException
//sampleEnd
}