컬렉션 변경하기
가변 컬렉션(Mutable collection)은 요소를 추가하거나 제거하는 등 컬렉션의 내용을 변경하는 연산을 지원합니다. 이 페이지에서는 MutableCollection의 모든 구현체에서 사용할 수 있는 쓰기 연산(write operation)에 대해 설명합니다. List 및 Map에서 사용할 수 있는 보다 구체적인 연산은 각각 List 관련 연산 및 Map 관련 연산을 참조하세요.
요소 추가하기
리스트나 세트에 단일 요소를 추가하려면 add() 함수를 사용합니다. 지정된 객체는 컬렉션의 끝에 추가됩니다.
fun main() {
val numbers = mutableListOf(1, 2, 3, 4)
numbers.add(5)
println(numbers)
}addAll()은 인자로 전달된 객체의 모든 요소를 리스트나 세트에 추가합니다. 인자는 Iterable, Sequence 또는 Array일 수 있습니다. 수신 객체(receiver)와 인자의 타입이 달라도 되며, 예를 들어 Set의 모든 항목을 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()는 리스트의 모든 요소를 제거하여 빈 상태로 만듭니다.
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)
}컬렉션에서 요소를 제거하는 또 다른 방법은 minus의 인플레이스 버전인 minusAssign(-=) 연산자를 사용하는 것입니다. 두 번째 피연산자는 요소 타입의 단일 인스턴스이거나 다른 컬렉션일 수 있습니다. 우변에 단일 요소가 오면, -=는 해당 요소가 처음 나타난 위치의 것을 제거합니다. 반대로 컬렉션이 오면, 해당 컬렉션에 포함된 요소와 일치하는 모든 요소가 제거됩니다. 예를 들어 리스트에 중복 요소가 포함되어 있다면 한 번에 제거됩니다. 두 번째 피연산자에는 컬렉션에 존재하지 않는 요소가 포함될 수도 있습니다. 이러한 요소는 연산 실행에 영향을 미치지 않습니다.
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 관련 연산에서 설명합니다. 세트(Set)의 경우 요소를 업데이트하는 것은 사실상 기존 요소를 제거하고 다른 요소를 추가하는 것과 같으므로 별도의 업데이트 연산이 제공되지 않습니다.
