UP | HOME

写操作

Table of Contents

可变集合支持更改集合内容的操作，例如添加或删除元素。 接下来将描述实现 MutableCollection 的所有写操作

添加元素

要将单个元素添加到列表或集合，请使用 add() 函数。指定的对象将添加到集合的 末尾 

fun main() {
//sampleStart
    val numbers = mutableListOf(1, 2, 3, 4)
    numbers.add(5)
    println(numbers)
//sampleEnd
}

addAll() 将参数对象的每个元素添加到列表或集合中。参数可以是 Iterable、Sequence 或 Array 

    接收者的类型和参数可能不同，例如，可以将所有内容从 Set 添加到 List

当在列表上调用时，addAll() 会按照在参数中出现的顺序添加各个新元素 

    也可以调用 addAll() 时指定一个元素位置作为第一参数

    参数集合的第一个元素会被插入到这个位置。 其他元素将跟随在它后面，将接收者元素移到末尾

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 运算符 += 添加元素。 当应用于可变集合时，+= 将第二个操作数(一个元素或另一个集合)追加到集合的 末尾 

fun main() {
//sampleStart
    val numbers = mutableListOf("one", "two")
    numbers += "three"
    println(numbers)
    numbers += listOf("four", "five")    
    println(numbers)
//sampleEnd
}

删除元素

若要从可变集合中移除元素，请使用 remove() 函数。 remove() 接受元素值，并删除该值的一个匹配项 

fun main() {
//sampleStart
    val numbers = mutableListOf(1, 2, 3, 4, 3)
    numbers.remove(3)                    // 删除了第一个 `3`
    println(numbers)
    numbers.remove(5)                    // 什么都没删除
    println(numbers)
//sampleEnd
}

要一次删除多个元素，有以下函数：

  • removeAll() 移除参数集合中存在的所有元素。 或者，你可以用谓词作为参数来调用它；在这种情况下，函数移除谓词产生 true 的所有元素
  • retainAll() 与 removeAll() 相反：它移除除参数集合中的元素之外的所有元素。 当与谓词一起使用时，它只留下与之匹配的元素
  • clear() 从列表中移除所有元素并将其置空
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
}

从集合中移除元素的另一种方法是使用 -= minus 操作符。第二个参数可以是元素类型的单个实例或另一个集合

  • 右边是单个元素时，-= 会移除它的第一个匹配项
  • 如果它是一个集合，那么它的所有元素的每次出现都会删除
    例如，如果列表包含重复的元素，它们将被同时删除

    第二个操作数可以包含集合中不存在的元素。这些元素不会影响操作的执行

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 相关操作与 Map 相关操作中有所描述

对于 set 来说，更新没有意义，因为它实际上是移除一个元素并添加另一个元素
Next：List Previous：聚合 Home：集合