Skip to content

集合操作概述 ​

Kotlin 标准库提供了丰富的函数用于对集合执行各种操作。这包括简单的操作(例如获取或添加元素),以及更复杂的操作(包括搜索、排序、过滤、转换等)。

扩展函数与成员函数 ​

标准库中声明集合操作的方式有两种:集合接口的成员函数以及扩展函数。

成员函数定义了对于某种集合类型而言必不可少的操作。例如,Collection 包含用于检查集合是否为空的 isEmpty() 函数;List 包含用于通过索引访问元素的 get() 等。

当你创建自己的集合接口实现时,必须实现其成员函数。为了更轻松地创建新实现,可以使用标准库中集合接口的骨架实现:AbstractCollection、AbstractList、AbstractSet、AbstractMap 及其可变对应项。

其他集合操作均声明为扩展函数。这些操作包括过滤、转换、排序以及其他集合处理函数。

通用操作 ​

通用操作既适用于只读集合也适用于可变集合。通用操作分为以下几类:

这些页面中介绍的操作都会返回其结果,而不会影响原始集合。例如,过滤操作会生成一个包含所有与过滤谓词匹配的元素的新集合。此类操作的结果应存储在变量中,或者以其他某种方式使用(例如传递给其他函数)。

kotlin

fun main() {
    val numbers = listOf("one", "two", "three", "four")  
    numbers.filter { it.length > 3 }  // `numbers` 没有发生任何变化,结果已丢失
    println("numbers are still $numbers")
    val longerThan3 = numbers.filter { it.length > 3 } // 结果存储在 `longerThan3` 中
    println("numbers longer than 3 chars are $longerThan3")
}

对于某些集合操作,可以选择指定目标 (destination) 对象。目标是一个可变集合,函数会将生成的结果项附加到该目标中,而不是在新的对象中返回它们。对于带目标的操作,有单独的函数,其名称带有 To 后缀,例如用 filterTo() 代替 filter(),或用 associateTo() 代替 associate()。这些函数将目标集合作为附加形参传入。

kotlin

fun main() {
    val numbers = listOf("one", "two", "three", "four")
    val filterResults = mutableListOf<String>()  // 目标对象
    numbers.filterTo(filterResults) { it.length > 3 }
    numbers.filterIndexedTo(filterResults) { index, _ -> index == 0 }
    println(filterResults) // 包含两个操作的结果
}

为了方便起见,这些函数会将目标集合返回,因此你可以直接在函数调用的对应实参中创建该集合:

kotlin

fun main() {
    val numbers = listOf("one", "two", "three", "four")
    // 将数字直接过滤到一个新的哈希集中,
    // 从而消除结果中的重复项
    val result = numbers.mapTo(HashSet()) { it.length }
    println("distinct item lengths are $result")
}

带有目标对象的函数可用于过滤、关联、分组、展平以及其他操作。有关目标操作的完整列表,请参阅 Kotlin 集合参考。

写入操作 ​

对于可变集合,还存在会更改集合状态的写入操作。此类操作包括添加、移除和更新元素。写入操作列在写入操作以及List 专属操作和Map 专属操作的对应章节中。

对于某些操作,存在执行相同操作的成对函数:一个就地应用操作,另一个将结果作为独立集合返回。例如,sort() 就地对可变集合进行排序,因此其状态会发生改变;而 sorted() 则会创建一个新集合,其中按排序顺序包含相同的元素。

kotlin

fun main() {
    val numbers = mutableListOf("one", "two", "three", "four")
    val sortedNumbers = numbers.sorted()
    println(numbers == sortedNumbers)  // false
    numbers.sort()
    println(numbers == sortedNumbers)  // true
}