sortByの使い方について

Question

sortByの使い方について質問です。

独自に作成したクラスを格納したリストがあるとします。
そのリストをクラス内の特定のプロパティでソートしたいと考えていました。
調べているとMutableList#sortByを使えば実現できそうだったのですが、リファレンスを見ても引数として何を渡すべきなのかよくわからなかったので質問させていただきました。

以下はリファレンスに載っていたコードと説明です。
(https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/sort-by.html)

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

Sorts elements in the list in-place according to natural sort order of the value returned by specified selector function.

これは引数として「(T)を渡すとR?を返す関数」を渡すという意味で合ってますでしょうか？((T)がリストの要素のことな気はするのですがR?が何なのかよくわかっていない）
また、説明のところに「selector function」とあるのですがこれがどういう関数なのかもわかりません。（要素から何を基準にソートするか選ぶ関数的な意味として使われているのでしょうか...？）

試しに以下のようなコードを書いて実行してみると上手く動作はするのですがいまいち理解できていません。（名前と年齢のプロパティを持つPersonクラスを格納したリストを年齢でソート）
これは引数として「リストの要素を渡すと要素のプロパティ(age)を返す関数」を渡していることになると思うのですが、上記のリファレンスに対する自分の認識と違うことになります（Comparable<R>とやらを返していない)

fun main(){

    val list: MutableList<Person> = mutableListOf()

    list.add(Person("Alice", 22))
    list.add(Person("Bob", 16))
    list.add(Person("Carol", 25))
    
    list.sortBy { it.age }
    println(list)
}

data class Person(val name: String, val age: Int)

質問をまとめると以下の2点です。

1. sortByの引数として何を渡すのが正しいのか？
2. 「selector function」とはどういうものか？（どういう意味で使われているのか）

まだまだ勉強し始めたばかりなのでリファレンスの見方やkotlinの文法をしっかり理解できていないのが原因だとは思いますがよろしくお願いします。

Answer 1

sortByの引数として何を渡すのが正しいのか？
「selector function」とはどういうものか？（どういう意味で使われているのか）

Comparable（比較可能）なものを返す「selector function」を渡します。
例えば提示されたit.ageだと、それぞれ22、16、25が返され、その３つの昇順で比較されPersonオブジェクトがソートされます。

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

はComparableを実装したRを返すTを指定することを示しています。
IntはComparableを実装しているので、it.ageは問題なく比較できます。

複雑なソート条件の場合は自分でComparableを返すfunctionを作ってソートさせることができます。

Comments

[tokumei000]

IntはComparableを実装しているから問題なかったのですね、理解できましたありがとうございます。
ちなみに「R : Comparable<R>」の「R」は何か英単語の略だったりするのでしょうか？（Tがtypeの略みたいに）

[nakasho_dev]

GenericsについてTypeにはTを使わなければいけないということはないです。なぜRなのかは推測するしかないのですがReturn(返却値)のことを現わしているかもしれません。

[tokumei000]

Returnが由来になってる可能性があるんですね、ありがとうございました。