elementAtOrNull

kotlin-stdlib/kotlin.collections/elementAtOrNull

Начиная с Kotlin: 1.0

inline fun <T> Array<out T>.elementAtOrNull(index: Int): T?

inline fun ByteArray.elementAtOrNull(index: Int): Byte?

inline fun ShortArray.elementAtOrNull(index: Int): Short?

inline fun IntArray.elementAtOrNull(index: Int): Int?

inline fun LongArray.elementAtOrNull(index: Int): Long?

inline fun FloatArray.elementAtOrNull(index: Int): Float?

inline fun DoubleArray.elementAtOrNull(index: Int): Double?

inline fun BooleanArray.elementAtOrNull(index: Int): Boolean?

inline fun CharArray.elementAtOrNull(index: Int): Char?

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

Примеры

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

fun main() { 
   //sampleStart 
   val list = listOf(1, 2, 3)
println(list.elementAtOrNull(0)) // 1
println(list.elementAtOrNull(2)) // 3
println(list.elementAtOrNull(3)) // null

val emptyList = emptyList<Int>()
println(emptyList.elementAtOrNull(0)) // null 
   //sampleEnd
}

fun <T> Iterable<T>.elementAtOrNull(index: Int): T?

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

Примеры

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

fun main() { 
   //sampleStart 
   val list = listOf(1, 2, 3)
println(list.elementAtOrNull(0)) // 1
println(list.elementAtOrNull(2)) // 3
println(list.elementAtOrNull(3)) // null

val emptyList = emptyList<Int>()
println(emptyList.elementAtOrNull(0)) // null 
   //sampleEnd
}

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

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

Примеры

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

fun main() { 
   //sampleStart 
   val list = listOf(1, 2, 3)
println(list.elementAtOrNull(0)) // 1
println(list.elementAtOrNull(2)) // 3
println(list.elementAtOrNull(3)) // null

val emptyList = emptyList<Int>()
println(emptyList.elementAtOrNull(0)) // null 
   //sampleEnd
}


@ExperimentalUnsignedTypes
inline fun UIntArray.elementAtOrNull(index: Int): UInt?


@ExperimentalUnsignedTypes
inline fun ULongArray.elementAtOrNull(index: Int): ULong?


@ExperimentalUnsignedTypes
inline fun UByteArray.elementAtOrNull(index: Int): UByte?


@ExperimentalUnsignedTypes
inline fun UShortArray.elementAtOrNull(index: Int): UShort?

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

Примеры

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

fun main() { 
   //sampleStart 
   val list = listOf(1, 2, 3)
println(list.elementAtOrNull(0)) // 1
println(list.elementAtOrNull(2)) // 3
println(list.elementAtOrNull(3)) // null

val emptyList = emptyList<Int>()
println(emptyList.elementAtOrNull(0)) // null 
   //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-or-null.html