# 集合写操作 [TOC] [可变集合](collections-overview.html#集合类型)支持更改集合内容的操作，例如添加或删除元素。 在此页面上，我们将描述实现 `MutableCollection` 的所有写操作。 有关 `List` 与 `Map` 可用的更多特定操作，请分别参见 [List 相关操作](list-operations.html)与 [Map 相关操作](map-operations.html)。 ## 添加元素 要将单个元素添加到列表或集合，请使用 [`add()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/add.html) 函数。指定的对象将添加到集合的末尾。 ```kotlin fun main() { //sampleStart val numbers = mutableListOf(1, 2, 3, 4) numbers.add(5) println(numbers) //sampleEnd } ``` [`addAll()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/add-all.html) 将参数对象的每个元素添加到列表或集合中。参数可以是 `Iterable`、`Sequence` 或 `Array`。 接收者的类型和参数可能不同，例如，你可以将所有内容从 `Set` 添加到 `List`。 当在列表上调用时，`addAll()` 会按照在参数中出现的顺序添加各个新元素。你也可以调用 `addAll()` 时指定一个元素位置作为第一参数。参数集合的第一个元素会被插入到这个位置。其他元素将跟随在它后面，将接收者元素移到末尾。 ```kotlin fun main() { //sampleStart val numbers = mutableListOf(1, 2, 5, 6) numbers.addAll(arrayOf(7, 8)) println(numbers) numbers.addAll(2, setOf(3, 4)) println(numbers) //sampleEnd } ``` 你还可以使用 [`plus` 运算符](collection-plus-minus.html) - [`plusAssign`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/plus-assign.html) (`+=`) 添加元素。当应用于可变集合时，`+=` 将第二个操作数(一个元素或另一个集合)追加到集合的末尾。 ```kotlin fun main() { //sampleStart val numbers = mutableListOf("one", "two") numbers += "three" println(numbers) numbers += listOf("four", "five") println(numbers) //sampleEnd } ``` ## 删除元素 若要从可变集合中移除元素，请使用 [`remove()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/remove.html) 函数。`remove()` 接受元素值，并删除该值的一个匹配项。 ```kotlin fun main() { //sampleStart val numbers = mutableListOf(1, 2, 3, 4, 3) numbers.remove(3) // 删除了第一个 `3` println(numbers) numbers.remove(5) // 什么都没删除 println(numbers) //sampleEnd } ``` 要一次删除多个元素，有以下函数： * [`removeAll()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/remove-all.html) 移除参数集合中存在的所有元素。或者，你可以用谓词作为参数来调用它；在这种情况下，函数移除谓词产生 `true` 的所有元素。 * [`retainAll()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/retain-all.html) 与 `removeAll()` 相反：它移除除参数集合中的元素之外的所有元素。当与谓词一起使用时，它只留下与之匹配的元素。 * [`clear()`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/clear.html) 从列表中移除所有元素并将其置空。 ```kotlin fun main() { //sampleStart val numbers = mutableListOf(1, 2, 3, 4) println(numbers) numbers.retainAll { it >= 3 } println(numbers) numbers.clear() println(numbers) val numbersSet = mutableSetOf("one", "two", "three", "four") numbersSet.removeAll(setOf("one", "two")) println(numbersSet) //sampleEnd } ``` 从集合中移除元素的另一种方法是使用 [`minusAssign`](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/minus-assign.html) (`-=`) ——原地修改版的 [`minus`](collection-plus-minus.html) 操作符。 [`minus`](collection-plus-minus.html) 操作符。第二个参数可以是元素类型的单个实例或另一个集合。右边是单个元素时，`-=` 会移除它的第一个匹配项。反过来，如果它是一个集合，那么它的所有元素的每次出现都会删除。例如，如果列表包含重复的元素，它们将被同时删除。第二个操作数可以包含集合中不存在的元素。这些元素不会影响操作的执行。 ```kotlin fun main() { //sampleStart val numbers = mutableListOf("one", "two", "three", "three", "four") numbers -= "three" println(numbers) numbers -= listOf("four", "five") //numbers -= listOf("four") // 与上述相同 println(numbers) //sampleEnd } ``` ## 更新元素 list 和 map 还提供更新元素的操作。它们在 [List 相关操作](list-operations.html)与 [Map 相关操作](map-operations.html)中有所描述。对于 set 来说，更新没有意义，因为它实际上是移除一个元素并添加另一个元素。