kotlin-stdlib/kotlin.sequences/last

last

fun <T> Sequence<T>.last(): T
Content copied to clipboard

Returns the last element.

The operation is terminal.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val list = listOf(1, 2, 3, 4)
assertPrints(list.last(), "4")
assertPrints(list.last { it % 2 == 1 }, "3")
assertPrints(list.lastOrNull { it < 0 }, "null")
assertFails { list.last { it < 0 } }

val emptyList = emptyList<Int>()
assertPrints(emptyList.lastOrNull(), "null")
assertFails { emptyList.last() } 
   //sampleEnd
}

Throws

if the sequence is empty.


inline fun <T> Sequence<T>.last(predicate: (T) -> Boolean): T
Content copied to clipboard

Returns the last element matching the given predicate.

The operation is terminal.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val list = listOf(1, 2, 3, 4)
assertPrints(list.last(), "4")
assertPrints(list.last { it % 2 == 1 }, "3")
assertPrints(list.lastOrNull { it < 0 }, "null")
assertFails { list.last { it < 0 } }

val emptyList = emptyList<Int>()
assertPrints(emptyList.lastOrNull(), "null")
assertFails { emptyList.last() } 
   //sampleEnd
}

Throws

if no such element is found.