Skip to content

集合分組 ​

Kotlin 標準函式庫提供了用於對集合元素進行分組的擴充函式。 基本函式 groupBy() 接受一個 Lambda 函式並傳回一個 Map。在此 Map 中,每個鍵都是該 Lambda 的執行結果,而對應的值則是產生此結果之元素的 List。例如,可以使用此函式將 String 清單依其首字母分組。

你也可以傳入第二個 Lambda 引數(值轉換函式)來呼叫 groupBy()。 在使用兩個 Lambda 的 groupBy() 結果 Map 中,由 keySelector 函式產生的鍵會對應到值轉換函式的結果,而不是原始元素。

此範例展示了如何使用 groupBy() 函式依字串的首字母進行分組、使用 for 運算子在產生的 Map 上遍歷各個分組,然後使用 valueTransform 函式將值轉換為大寫:

kotlin
fun main() {
    val numbers = listOf("one", "two", "three", "four", "five")

    // 使用 groupBy() 依字串的首字母分組
    val groupedByFirstLetter = numbers.groupBy { it.first().uppercase() }
    println(groupedByFirstLetter)
    // {O=[one], T=[two, three], F=[four, five]}

    // 遍歷每個分組並印出鍵及其關聯的值
    for ((key, value) in groupedByFirstLetter) {
        println("Key: $key, Values: $value")
    }
    // Key: O, Values: [one]
    // Key: T, Values: [two, three]
    // Key: F, Values: [four, five]

    // 依首字母分組字串並將值轉換為大寫
    val groupedAndTransformed = numbers.groupBy(keySelector = { it.first() }, valueTransform = { it.uppercase() })
    println(groupedAndTransformed)
    // {o=[ONE], t=[TWO, THREE], f=[FOUR, FIVE]}
}

如果你想要對元素進行分組,然後一次對所有分組套用某個操作,請使用 groupingBy() 函式。 它會傳回一個 Grouping 型別的執行個體。Grouping 執行個體可讓你以延遲方式對所有分組套用操作:分組實際上會在操作執行前一刻才建立。

具體來說,Grouping 支援以下操作:

  • eachCount() 計算每個分組中的元素數量。
  • fold() 與 reduce() 將每個分組視為獨立集合來執行折疊與歸約 (fold and reduce) 操作,並傳回結果。
  • aggregate() 依序將指定操作套用至每個分組中的所有元素並傳回結果。 這是在 Grouping 上執行任何操作的通用方式。當 fold 或 reduce 無法滿足需求時,可用它來實作自訂操作。

你可以在產生的 Map 上使用 for 運算子遍歷由 groupingBy() 函式建立的分組。 這可讓你存取每個鍵以及與該鍵關聯的元素計數。

以下範例展示了如何使用 groupingBy() 函式依字串的首字母分組、計算每個分組中的元素數量,然後遍歷每個分組以印出鍵和元素數量:

kotlin
fun main() {
    val numbers = listOf("one", "two", "three", "four", "five")

    // 使用 groupingBy() 依首字母分組字串並計算每個分組中的元素數量
    val grouped = numbers.groupingBy { it.first() }.eachCount()

    // 遍歷每個分組並印出鍵及其關聯的值
    for ((key, count) in grouped) {
        println("Key: $key, Count: $count")
        // Key: o, Count: 1
        // Key: t, Count: 2
        // Key: f, Count: 2
    }
}