Skip to content

修改集合 ​

可變集合支援用於變更集合內容的操作,例如新增或移除元素。 在此頁面中,我們將介紹適用於所有 MutableCollection 實作的寫入操作。 關於適用於 List 和 Map 的更具體操作,請分別參閱 List 專屬操作與 Map 專屬操作。

新增元素 ​

若要向 list 或 set 新增單一元素,請使用 add() 函式。指定的物件會附加到集合的末尾。

kotlin

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

addAll() 會將引數物件中的每個元素新增到 list 或 set 中。該引數可以是 Iterable、Sequence 或 Array。 接收者與引數的型別可以不同,例如,你可以將 Set 中的所有項目新增到 List 中。

在 list 上呼叫時,addAll() 會依照新元素在引數中的順序新增它們。 你也可以在呼叫 addAll() 時,將元素位置指定為第一個引數。 引數集合的第一個元素將插入到該位置。 引數集合中的其他元素將緊隨其後,並將接收者中的既有元素推向末尾。

kotlin

fun main() {
    val numbers = mutableListOf(1, 2, 5, 6)
    numbers.addAll(arrayOf(7, 8))
    println(numbers)
    numbers.addAll(2, setOf(3, 4))
    println(numbers)
}

你也可以使用 plus 運算子的就地(in-place)版本——plusAssign(+=)來新增元素。 當套用於可變集合時,+= 會將第二個運算元(元素或另一個集合)附加到集合的末尾。

kotlin

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

移除元素 ​

若要從可變集合中移除元素,請使用 remove() 函式。 remove() 接受元素值,並移除該值第一次出現的項目。

kotlin

fun main() {
    val numbers = mutableListOf(1, 2, 3, 4, 3)
    numbers.remove(3)                    // 移除第一個 `3`
    println(numbers)
    numbers.remove(5)                    // 不移除任何內容
    println(numbers)
}

若要一次移除多個元素,可以使用以下函式:

  • removeAll() 會移除所有存在於引數集合中的元素。 或者,你也可以傳入一個述詞(predicate)作為引數;在這種情況下,該函式會移除述詞結果為 true 的所有元素。
  • retainAll() 與 removeAll() 相反:它會移除除了引數集合中的元素以外的所有元素。 與述詞一起使用時,它只會保留符合條件的元素。
  • clear() 會從 list 中移除所有元素,使其變為空。
kotlin

fun main() {
    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)
}

從集合中移除元素的另一種方法是使用 minusAssign(-=)運算子——minus 的就地版本。 第二個引數可以是該元素型別的單一執行個體,也可以是另一個集合。 當右側為單一元素時,-= 會移除它 第一次 出現的項目。 反之,若右側是一個集合,則會移除其元素出現的 所有 項目。 例如,如果 list 包含重複的元素,它們會被一次全數移除。 第二個運算元可以包含集合中不存在的元素。這些元素不會影響操作的執行。

kotlin

fun main() {
    val numbers = mutableListOf("one", "two", "three", "three", "four")
    numbers -= "three"
    println(numbers)
    numbers -= listOf("four", "five")    
    //numbers -= listOf("four")    // 效果與上述相同
    println(numbers)    
}

更新元素 ​

List 與 Map 還提供了用於更新元素的操作。 它們分別在 List 專屬操作和 Map 專屬操作中進行說明。 對於 Set 而言,更新元素沒有意義,因為實質上它等同於移除一個元素並新增另一個元素。