inline fun <T, R : Comparable<R>> Sequence<T>.sortedBy(
    crossinline selector: (T) -> R?
): Sequence<T>

Returns a sequence that yields elements of this sequence sorted according to natural sort order of the value returned by specified selector function.

The sort is stable. It means that equal elements preserve their order relative to each other after sorting.

The operation is intermediate and stateful.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val list = listOf("aaa", "cc", "bbbb")
val sorted = list.sortedBy { it.length }

println(list) // [aaa, cc, bbbb]
println(sorted) // [cc, aaa, bbbb]
//sampleEnd
}