Функция elementAtOrNull

Функция elementAtOrNull возвращает элемент коллекции по указанному индексу. Если индекс выходит за границы коллекции (меньше 0 или больше/равен размеру коллекции), функция возвращает null вместо выбрасывания исключения. Применяется к массивам, спискам, множествам и другим коллекциям.

Импорт

kotlinimport kotlin.collections.elementAtOrNull

Синтаксис

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

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

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

Пример

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

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

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

kotlinChar 'c'

Пример

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

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

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

kotlinnull

Пример

Использование с множеством:

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

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

kotlinString "banana"

Пример

Безопасная обработка результата с помощью оператора элвис:

kotlinval numbers = arrayOf(10, 20, 30)
val index = 5
val result = numbers.elementAtOrNull(index) ?: -1
println("Element at index $index: $result")

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

kotlinElement at index 5: -1

Для каких типов коллекций работает

Функция elementAtOrNull работает со следующими типами коллекций:

• Array - массивы
• List - списки
• Set - множества
• Iterable - любые итерируемые коллекции
• Sequence - последовательности
• CharArray, IntArray, DoubleArray и другие примитивные массивы

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