elementAt

kotlin-stdlib/kotlin.collections/elementAt

Требования к платформе и версии: Common (1.0)

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

Возвращает элемент по заданному индексу или выбрасывает IndexOutOfBoundsException, если индекс выходит за границы этой коллекции.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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
}

inline fun <T> List<T>.elementAt(index: Int): T

Возвращает элемент по заданному индексу или выбрасывает IndexOutOfBoundsException, если индекс выходит за границы этого списка.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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
}

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

expect fun ByteArray.elementAt(index: Int): Byte

expect fun ShortArray.elementAt(index: Int): Short

expect fun IntArray.elementAt(index: Int): Int

expect fun LongArray.elementAt(index: Int): Long

expect fun FloatArray.elementAt(index: Int): Float

expect fun DoubleArray.elementAt(index: Int): Double

expect fun BooleanArray.elementAt(index: Int): Boolean

expect fun CharArray.elementAt(index: Int): Char

Возвращает элемент по заданному индексу или выбрасывает IndexOutOfBoundsException, если индекс выходит за границы этого массива.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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
}


@ExperimentalUnsignedTypes
expect fun UIntArray.elementAt(index: Int): UInt


@ExperimentalUnsignedTypes
expect fun ULongArray.elementAt(index: Int): ULong


@ExperimentalUnsignedTypes
expect fun UByteArray.elementAt(index: Int): UByte


@ExperimentalUnsignedTypes
expect fun UShortArray.elementAt(index: Int): UShort

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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.1)

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

actual fun ByteArray.elementAt(index: Int): Byte

actual fun ShortArray.elementAt(index: Int): Short

actual fun IntArray.elementAt(index: Int): Int

actual fun LongArray.elementAt(index: Int): Long

actual fun FloatArray.elementAt(index: Int): Float

actual fun DoubleArray.elementAt(index: Int): Double

actual fun BooleanArray.elementAt(index: Int): Boolean

actual fun CharArray.elementAt(index: Int): Char

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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
}


@ExperimentalUnsignedTypes
actual fun UIntArray.elementAt(index: Int): UInt


@ExperimentalUnsignedTypes
actual fun ULongArray.elementAt(index: Int): ULong


@ExperimentalUnsignedTypes
actual fun UByteArray.elementAt(index: Int): UByte


@ExperimentalUnsignedTypes
actual fun UShortArray.elementAt(index: Int): UShort

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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
}

Требования к платформе и версии: JVM (1.0)

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

actual inline fun ByteArray.elementAt(index: Int): Byte

actual inline fun ShortArray.elementAt(index: Int): Short

actual inline fun IntArray.elementAt(index: Int): Int

actual inline fun LongArray.elementAt(index: Int): Long

actual inline fun FloatArray.elementAt(index: Int): Float

actual inline fun DoubleArray.elementAt(index: Int): Double

actual inline fun BooleanArray.elementAt(index: Int): Boolean

actual inline fun CharArray.elementAt(index: Int): Char

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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
}


@ExperimentalUnsignedTypes
actual inline fun UIntArray.elementAt(index: Int): UInt


@ExperimentalUnsignedTypes
actual inline fun ULongArray.elementAt(index: Int): ULong


@ExperimentalUnsignedTypes
actual inline fun UByteArray.elementAt(index: Int): UByte


@ExperimentalUnsignedTypes
actual inline fun UShortArray.elementAt(index: Int): UShort

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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
}

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

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

actual inline fun ByteArray.elementAt(index: Int): Byte

actual inline fun ShortArray.elementAt(index: Int): Short

actual inline fun IntArray.elementAt(index: Int): Int

actual inline fun LongArray.elementAt(index: Int): Long

actual inline fun FloatArray.elementAt(index: Int): Float

actual inline fun DoubleArray.elementAt(index: Int): Double

actual inline fun BooleanArray.elementAt(index: Int): Boolean

actual inline fun CharArray.elementAt(index: Int): Char


@ExperimentalUnsignedTypes
actual inline fun UIntArray.elementAt(index: Int): UInt


@ExperimentalUnsignedTypes
actual inline fun ULongArray.elementAt(index: Int): ULong


@ExperimentalUnsignedTypes
actual inline fun UByteArray.elementAt(index: Int): UByte


@ExperimentalUnsignedTypes
actual inline fun UShortArray.elementAt(index: Int): UShort

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //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
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/element-at.html