getOrNull

kotlin-stdlib/kotlin.collections/getOrNull

Начиная с Kotlin: 1.0

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

fun ByteArray.getOrNull(index: Int): Byte?

fun ShortArray.getOrNull(index: Int): Short?

fun IntArray.getOrNull(index: Int): Int?

fun LongArray.getOrNull(index: Int): Long?

fun FloatArray.getOrNull(index: Int): Float?

fun DoubleArray.getOrNull(index: Int): Double?

fun BooleanArray.getOrNull(index: Int): Boolean?

fun CharArray.getOrNull(index: Int): Char?

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

Примеры

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

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

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

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

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

Примеры

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

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

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


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


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


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


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

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

Примеры

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

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

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