last

Common
JVM
JS
Native
1.0
fun <T> Array<out T>.last(): T
fun ByteArray.last(): Byte
fun ShortArray.last(): Short
fun IntArray.last(): Int
fun LongArray.last(): Long
fun FloatArray.last(): Float
fun DoubleArray.last(): Double
fun BooleanArray.last(): Boolean
fun CharArray.last(): Char
@ExperimentalUnsignedTypes fun UIntArray.last(): UInt
@ExperimentalUnsignedTypes fun ULongArray.last(): ULong
@ExperimentalUnsignedTypes fun UByteArray.last(): UByte
@ExperimentalUnsignedTypes fun UShortArray.last(): UShort

Returns the last element.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3, 4)
println(list.last()) // 4
println(list.last { it % 2 == 1 }) // 3
println(list.lastOrNull { it < 0 }) // null
// list.last { it < 0 } //  will fail

val emptyList = emptyList<Int>()
println(emptyList.lastOrNull()) // null
// emptyList.last() //  will fail
//sampleEnd
}

Exceptions

NoSuchElementException - if the array is empty.

Common
JVM
JS
Native
1.0
inline fun <T> Array<out T>.last(
    predicate: (T) -> Boolean
): T
inline fun ByteArray.last(predicate: (Byte) -> Boolean): Byte
inline fun ShortArray.last(
    predicate: (Short) -> Boolean
): Short
inline fun IntArray.last(predicate: (Int) -> Boolean): Int
inline fun LongArray.last(predicate: (Long) -> Boolean): Long
inline fun FloatArray.last(
    predicate: (Float) -> Boolean
): Float
inline fun DoubleArray.last(
    predicate: (Double) -> Boolean
): Double
inline fun BooleanArray.last(
    predicate: (Boolean) -> Boolean
): Boolean
inline fun CharArray.last(predicate: (Char) -> Boolean): Char
inline fun <T> Iterable<T>.last(predicate: (T) -> Boolean): T
inline fun <T> List<T>.last(predicate: (T) -> Boolean): T
@ExperimentalUnsignedTypes inline fun UIntArray.last(
    predicate: (UInt) -> Boolean
): UInt
@ExperimentalUnsignedTypes inline fun ULongArray.last(
    predicate: (ULong) -> Boolean
): ULong
@ExperimentalUnsignedTypes inline fun UByteArray.last(
    predicate: (UByte) -> Boolean
): UByte
@ExperimentalUnsignedTypes inline fun UShortArray.last(
    predicate: (UShort) -> Boolean
): UShort

Returns the last element matching the given predicate.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3, 4)
println(list.last()) // 4
println(list.last { it % 2 == 1 }) // 3
println(list.lastOrNull { it < 0 }) // null
// list.last { it < 0 } //  will fail

val emptyList = emptyList<Int>()
println(emptyList.lastOrNull()) // null
// emptyList.last() //  will fail
//sampleEnd
}

Exceptions

NoSuchElementException - if no such element is found.

Common
JVM
JS
Native
1.0
fun <T> Iterable<T>.last(): T

Returns the last element.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3, 4)
println(list.last()) // 4
println(list.last { it % 2 == 1 }) // 3
println(list.lastOrNull { it < 0 }) // null
// list.last { it < 0 } //  will fail

val emptyList = emptyList<Int>()
println(emptyList.lastOrNull()) // null
// emptyList.last() //  will fail
//sampleEnd
}

Exceptions

NoSuchElementException - if the collection is empty.

Common
JVM
JS
Native
1.0
fun <T> List<T>.last(): T

Returns the last element.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf(1, 2, 3, 4)
println(list.last()) // 4
println(list.last { it % 2 == 1 }) // 3
println(list.lastOrNull { it < 0 }) // null
// list.last { it < 0 } //  will fail

val emptyList = emptyList<Int>()
println(emptyList.lastOrNull()) // null
// emptyList.last() //  will fail
//sampleEnd
}

Exceptions

NoSuchElementException - if the list is empty.