Map 전용 연산
Map에서는 키와 값의 타입 모두 사용자가 정의합니다. 키 기반의 Map 엔트리 접근 방식을 통해 키로 값을 가져오는 것부터 키와 값을 개별적으로 필터링하는 것까지 다양한 Map 전용 처리 기능을 사용할 수 있습니다. 이 페이지에서는 표준 라이브러리에서 제공하는 Map 처리 함수들을 설명합니다.
키 및 값 조회
Map에서 값을 가져오려면 get() 함수의 인자로 키를 전달해야 합니다. 단축 구문인 [key]도 지원됩니다. 지정한 키를 찾을 수 없는 경우 null을 반환합니다. 동작 방식이 약간 다른 getValue() 함수도 있습니다. 이 함수는 Map에서 키를 찾지 못하면 예외를 던집니다. 또한, 키가 없을 때의 동작을 처리할 수 있는 다음과 같은 추가 옵션도 제공됩니다.
getOrElse(): List에서와 동일하게 동작하며, 존재하지 않는 키에 대해서는 지정된 람다 함수가 반환하는 값을 반환합니다.getOrDefault(): 키를 찾을 수 없을 때 지정된 기본값을 반환합니다.
null을 허용하는(nullable) 값을 가진 Map의 경우, 누락된 키와 null 값을 명시적으로 처리하는 다음 함수들을 대신 사용할 수 있습니다.
getOrElseIfNull(): 키가 없거나 값이null인 경우 지정된 기본값의 결과를 반환합니다.getOrElseIfMissing(): 키가 누락된 경우에만 지정된 기본값의 결과를 반환합니다.
다음은 이러한 함수들 간의 차이점을 보여주는 예제입니다.
@OptIn(ExperimentalStdlibApi::class)
fun main() {
val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
println(numbersMap.get("one"))
// 1
println(numbersMap["one"])
// 1
println(numbersMap.getOrDefault("four", 10))
// 10
println(numbersMap["five"])
// null
val nullableMap = mapOf("one" to 1, "two" to null)
println(nullableMap.getOrElseIfNull("two") { 0 })
// 0
println(nullableMap.getOrElseIfMissing("two") { 0 })
// null
// Map에 "six"가 없으므로 예외를 던집니다
// numbersMap.getValue("six")
}Map의 모든 키나 모든 값에 대해 연산을 수행하려면 각각 keys와 values 프로퍼티에서 이를 가져올 수 있습니다. keys는 Map의 모든 키로 구성된 Set이며, values는 Map의 모든 값으로 구성된 컬렉션입니다.
fun main() {
val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
println(numbersMap.keys)
println(numbersMap.values)
}필터
다른 컬렉션과 마찬가지로 filter() 함수를 사용하여 Map을 필터링할 수 있습니다. Map에서 filter()를 호출할 때는 Pair를 인자로 받는 술어(predicate)를 전달합니다. 이를 통해 필터링 조건에서 키와 값을 모두 활용할 수 있습니다.
fun main() {
val numbersMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3, "key11" to 11)
val filteredMap = numbersMap.filter { (key, value) -> key.endsWith("1") && value > 10}
println(filteredMap)
}또한 Map을 필터링하는 데 특화된 두 가지 방식이 있습니다. 바로 키를 기준으로 필터링하는 방식과 값을 기준으로 필터링하는 방식입니다. 각각에 해당하는 함수로 filterKeys()와 filterValues()가 제공됩니다. 두 함수 모두 주어진 조건과 일치하는 엔트리들로 구성된 새로운 Map을 반환합니다. filterKeys()의 조건식은 요소의 키만 확인하고, filterValues()의 조건식은 값만 확인합니다.
fun main() {
val numbersMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3, "key11" to 11)
val filteredKeysMap = numbersMap.filterKeys { it.endsWith("1") }
val filteredValuesMap = numbersMap.filterValues { it < 10 }
println(filteredKeysMap)
println(filteredValuesMap)
}Plus 및 minus 연산자
요소에 대한 키 기반 접근 방식 때문에 plus (+) 및 minus (-) 연산자는 Map에서 다른 컬렉션과 다르게 동작합니다. plus는 좌변의 Map과 우변의 Pair 또는 또 다른 Map이라는 두 피연산자의 요소를 모두 포함하는 Map을 반환합니다. 우변 피연산자에 좌변 Map에 이미 존재하는 키를 가진 엔트리가 포함되어 있다면, 결과 Map에는 우변의 엔트리가 포함됩니다.
fun main() {
val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
println(numbersMap + Pair("four", 4))
println(numbersMap + Pair("one", 10))
println(numbersMap + mapOf("five" to 5, "one" to 11))
}minus는 좌변의 Map 엔트리 중 우변 피연산자에 지정된 키를 가진 엔트리를 제외한 Map을 생성합니다. 따라서 우변 피연산자에는 단일 키가 오거나 List, Set 등의 키 컬렉션이 올 수 있습니다.
fun main() {
val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
println(numbersMap - "one")
println(numbersMap - listOf("two", "four"))
}가변(mutable) Map에서 plusAssign (+=) 및 minusAssign (-=) 연산자를 사용하는 방법에 대한 자세한 내용은 아래의 Map 쓰기 연산을 참고하세요.
Map 쓰기 연산
가변(Mutable) Map은 Map 전용 쓰기 연산을 제공합니다. 이러한 연산을 사용하면 값에 대한 키 기반 접근을 통해 Map의 내용을 변경할 수 있습니다.
Map의 쓰기 연산을 정의하는 몇 가지 규칙이 있습니다.
- 값은 업데이트할 수 있습니다. 반면 키는 절대 변경되지 않습니다. 즉, 엔트리를 추가하면 해당 키는 불변입니다.
- 각 키에는 항상 단 하나의 값만 연결됩니다. 엔트리 전체를 추가하거나 제거할 수 있습니다.
아래는 가변 Map에서 사용할 수 있는 표준 라이브러리 쓰기 연산 함수에 대한 설명입니다.
엔트리 추가 및 업데이트
가변 Map에 새로운 키-값 쌍을 추가하려면 put()을 사용합니다. 새로운 엔트리가 LinkedHashMap(기본 Map 구현체)에 추가되면, Map을 순회할 때 가장 마지막에 나오도록 추가됩니다. 정렬된 Map의 경우 새 요소의 위치는 키의 순서에 따라 결정됩니다.
fun main() {
val numbersMap = mutableMapOf("one" to 1, "two" to 2)
numbersMap.put("three", 3)
println(numbersMap)
}한 번에 여러 엔트리를 추가하려면 putAll()을 사용합니다. 이 함수의 인자로는 Map이나 Iterable, Sequence, Array 같은 Pair 그룹이 올 수 있습니다.
fun main() {
val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
numbersMap.putAll(setOf("four" to 4, "five" to 5))
println(numbersMap)
}put()과 putAll() 모두 주어진 키가 이미 Map에 존재하면 값을 덮어씁니다. 따라서 이 함수들을 사용하여 Map 엔트리의 값을 업데이트할 수 있습니다.
fun main() {
val numbersMap = mutableMapOf("one" to 1, "two" to 2)
val previousValue = numbersMap.put("one", 11)
println("value associated with 'one', before: $previousValue, after: ${numbersMap["one"]}")
println(numbersMap)
}단축 연산자 형태를 사용하여 Map에 새 엔트리를 추가할 수도 있습니다. 두 가지 방법이 있습니다.
plusAssign(+=) 연산자set()의 별칭인[]연산자
fun main() {
val numbersMap = mutableMapOf("one" to 1, "two" to 2)
numbersMap["three"] = 3 // numbersMap.put("three", 3)을 호출합니다
numbersMap += mapOf("four" to 4, "five" to 5)
println(numbersMap)
}Map에 이미 존재하는 키로 호출하면, 연산자는 해당 엔트리의 값을 덮어씁니다.
누락된 엔트리에 기본값 추가
기존 값을 반환하거나, 사용할 수 있는 값이 없을 때 기본값을 추가하려면 .getOrPut() 확장 함수를 사용합니다. 키가 없거나 값이 null인 경우 .getOrPut()은 기본값을 저장하고 해당 값을 반환합니다.
null을 허용하는 값을 가진 Map의 경우, .getOrPutIfNull() 및 .getOrPutIfMissing() 함수를 사용하여 null 값을 처리하는 방식을 제어할 수 있습니다.
getOrPutIfNull():getOrPut()과 유사하게 동작하며, 키가 누락되었거나 값이null인 경우 기본값을 사용합니다.getOrPutIfMissing(): 키가 누락된 경우에만 기본값을 사용합니다.
getOrPutIfNull() 및 getOrPutIfMissing() 함수는 실험적(Experimental) 기능입니다. 사용하려면 @OptIn(ExperimentalStdlibApi::class) 애너테이션을 적용해야 합니다.
다음은 예제입니다.
@OptIn(ExperimentalStdlibApi::class)
fun main() {
val mapForNull = mutableMapOf<String, Int?>("one" to null)
val mapForMissing = mutableMapOf<String, Int?>("one" to null)
// "one"이 null 값을 가지므로 값을 대체합니다
mapForNull.getOrPutIfNull("one") { 1 }
println(mapForNull)
// {one=1}
// "one"이 Map에 존재하므로 null 값을 유지합니다
mapForMissing.getOrPutIfMissing("one") { 1 }
println(mapForMissing)
// {one=null}
}엔트리 제거
가변 Map에서 엔트리를 제거하려면 remove() 함수를 사용합니다. remove()를 호출할 때는 키만 전달하거나 키-값 쌍 전체를 전달할 수 있습니다. 키와 값을 모두 지정하는 경우, 해당 키를 가진 요소의 값이 두 번째 인자와 일치할 때만 제거됩니다.
fun main() {
val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
numbersMap.remove("one")
println(numbersMap)
numbersMap.remove("three", 4) // 아무것도 제거되지 않습니다
println(numbersMap)
}키나 값을 기준으로 가변 Map에서 엔트리를 제거할 수도 있습니다. 이를 수행하려면 Map의 keys나 values에 대해 엔트리의 키 또는 값을 전달하여 remove()를 호출합니다. values에 대해 호출하는 경우, remove()는 주어진 값을 가진 첫 번째 엔트리만 제거합니다.
fun main() {
val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3, "threeAgain" to 3)
numbersMap.keys.remove("one")
println(numbersMap)
numbersMap.values.remove(3)
println(numbersMap)
}가변 Map에서는 minusAssign (-=) 연산자도 사용할 수 있습니다.
fun main() {
val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
numbersMap -= "two"
println(numbersMap)
numbersMap -= "five" // 아무것도 제거되지 않습니다
println(numbersMap)
}