last

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

Returns the last element.

The operation is terminal .

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 sequence is empty.

Common
JVM
JS
Native
1.0
inline fun < T > Sequence < T > . last ( predicate : ( T ) -> Boolean ) : T
(source)

Returns the last element matching the given predicate .

The operation is terminal .

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.