修改集合
可變集合支援用於變更集合內容的操作,例如新增或移除元素。 在此頁面中,我們將介紹適用於所有 MutableCollection 實作的寫入操作。 關於適用於 List 和 Map 的更具體操作,請分別參閱 List 專屬操作與 Map 專屬操作。
新增元素
若要向 list 或 set 新增單一元素,請使用 add() 函式。指定的物件會附加到集合的末尾。
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() 時,將元素位置指定為第一個引數。 引數集合的第一個元素將插入到該位置。 引數集合中的其他元素將緊隨其後,並將接收者中的既有元素推向末尾。
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(+=)來新增元素。 當套用於可變集合時,+= 會將第二個運算元(元素或另一個集合)附加到集合的末尾。
fun main() {
val numbers = mutableListOf("one", "two")
numbers += "three"
println(numbers)
numbers += listOf("four", "five")
println(numbers)
}移除元素
若要從可變集合中移除元素,請使用 remove() 函式。 remove() 接受元素值,並移除該值第一次出現的項目。
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 中移除所有元素,使其變為空。
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 包含重複的元素,它們會被一次全數移除。 第二個運算元可以包含集合中不存在的元素。這些元素不會影響操作的執行。
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 而言,更新元素沒有意義,因為實質上它等同於移除一個元素並新增另一個元素。
