9.1.1.9.1 集合操作概览

3 分钟阅读

原文链接: https://kotlinlang.org/docs/collection-operations.html

9.1.1.9.1 集合操作概览

Kotlin 标准库提供了种类丰富的函数用于对集合执行操作。这既包括获取或添加元素这样的简单操作，也包括搜索、排序、过滤、转换等更复杂的操作。

扩展函数与成员函数

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

成员函数定义了集合类型必不可少的操作。例如，Collection 包含用于检查是否为空的函数 isEmpty()；List 包含用于按索引访问元素的 get()，等等。

当你创建集合接口的自定义实现时，必须实现它们的成员函数。为了让创建新实现更容易，请使用标准库中集合接口的骨架实现：AbstractCollection、AbstractList、AbstractSet、AbstractMap 以及它们对应的可变版本。

其他集合操作声明为扩展函数。它们是过滤、转换、排序以及其他集合处理函数。

通用操作

通用操作对只读集合和可变集合都可用。通用操作可分为以下几组：

这些页面上描述的操作在返回结果时不会影响原集合。例如，过滤操作会产生一个新集合，其中包含所有匹配过滤条件的元素。这类操作的结果应当存入变量，或以其他方式使用，例如传给其他函数。

1
2
3
4
5
6
7
8

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")
}

对于某些集合操作，可以选择指定目标对象。目标是一个可变集合，函数会把结果项追加到它里面，而不是以新对象的形式返回。要执行带目标的操作，可以使用名称带 To 后缀的单独函数，例如用 filterTo() 代替 filter()，或用 associateTo() 代替 associate()。这些函数会把目标集合作为额外参数。

1
2
3
4
5
6
7
8

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) // 包含两个操作的结果
}

为方便起见，这些函数会把目标集合返回，因此你可以直接在函数调用的相应实参中创建它：

1
2
3
4
5
6
7
8

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

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

写操作

对于可变集合，还有会改变集合状态的写操作。这类操作包括添加、移除和更新元素。写操作列在写操作以及 List 特有操作和映射特有操作的相应章节中。

对于某些操作，有成对的函数执行同样的操作：一个原地应用该操作，另一个把结果作为单独的集合返回。例如，sort() 会原地排序可变集合，因此它的状态会改变；sorted() 则创建一个新集合，其中包含按排序顺序排列的相同元素。

1
2
3
4
5
6
7
8

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

最后修改 September 13, 2026: 更新C和Cpp以及新增Kotlin和SwiftUI (d20dcaaa6)