Map 전용 연산

맵에서 키와 값의 타입은 모두 사용자 정의입니다. 맵 엔트리에 대한 키 기반 접근은 키를 사용하여 값을 가져오는 것부터 키와 값을 개별적으로 필터링하는 것까지 다양한 맵 전용 처리 기능을 제공합니다. 이 페이지에서는 표준 라이브러리에서 제공하는 맵 처리 함수들에 대해 설명합니다.

키와 값 추출

맵에서 값을 추출하려면 해당 키를 get() 함수의 인자로 제공해야 합니다. [key] 단축 구문도 지원됩니다. 지정된 키를 찾을 수 없으면 null을 반환합니다. 동작이 약간 다른 getValue() 함수도 있습니다. 이 함수는 맵에서 키를 찾을 수 없는 경우 예외를 발생시킵니다. 또한, 키가 없을 때를 처리하기 위한 두 가지 옵션이 더 있습니다.

• getOrElse()는 리스트와 동일하게 작동합니다. 존재하지 않는 키에 대한 값은 지정된 람다 함수에서 반환됩니다.
• getOrDefault()는 키를 찾을 수 없는 경우 지정된 기본값을 반환합니다.

null이 될 수 있는(nullable) 값을 가진 맵의 경우, 누락된 키와 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

    // 맵에 "six"가 없으므로 예외를 발생시킵니다.
    // numbersMap.getValue("six")

}

맵의 모든 키 또는 모든 값에 대해 연산을 수행하려면 keys 및 values 프로퍼티에서 각각 이를 추출할 수 있습니다. keys는 맵의 모든 키를 담은 세트(set)이며, values는 맵의 모든 값을 담은 컬렉션입니다.

fun main() {
    val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
    println(numbersMap.keys)
    println(numbersMap.values)
}

필터링 (Filter)

다른 컬렉션과 마찬가지로 filter() 함수를 사용하여 맵을 필터링할 수 있습니다. 맵에서 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)
}

맵을 필터링하는 두 가지 특정한 방법이 더 있습니다. 바로 키에 의한 필터링과 값에 의한 필터링입니다. 각각에 대해 filterKeys() 및 filterValues() 함수가 있습니다. 두 함수 모두 지정된 서술어와 일치하는 엔트리들로 구성된 새로운 맵을 반환합니다. 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는 두 피연산자의 요소를 모두 포함하는 Map을 반환합니다. 왼쪽에는 Map이 오고 오른쪽에는 Pair 또는 다른 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을 생성합니다. 따라서 오른쪽 피연산자는 단일 키이거나 리스트, 세트 등과 같은 키 컬렉션일 수 있습니다.

fun main() {
    val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
    println(numbersMap - "one")
    println(numbersMap - listOf("two", "four"))
}

가변 맵에서 plusAssign (+=) 및 minusAssign (-=) 연산자를 사용하는 방법에 대한 자세한 내용은 아래의 맵 쓰기 연산을 참조하세요.

맵 쓰기 연산

가변(Mutable) 맵은 맵 전용 쓰기 연산을 제공합니다. 이러한 연산을 사용하면 값에 대한 키 기반 접근을 통해 맵 내용을 변경할 수 있습니다.

맵의 쓰기 연산을 정의하는 몇 가지 규칙이 있습니다.

• 값은 업데이트될 수 있습니다. 반면 키는 절대 변하지 않습니다. 일단 엔트리를 추가하면 그 키는 고정됩니다.
• 각 키에는 항상 단일 값만 연결됩니다. 엔트리 전체를 추가하거나 제거할 수 있습니다.

아래는 가변 맵에서 사용할 수 있는 표준 라이브러리의 쓰기 연산 함수들에 대한 설명입니다.

엔트리 추가 및 업데이트

가변 맵에 새로운 키-값 쌍을 추가하려면 put()을 사용하세요. LinkedHashMap(기본 맵 구현체)에 새로운 엔트리가 추가될 때, 맵을 반복(iterate)할 때 가장 마지막에 오도록 추가됩니다. 정렬된 맵(sorted maps)에서는 새로운 요소의 위치가 키의 순서에 의해 결정됩니다.

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() 모두 지정된 키가 맵에 이미 존재하는 경우 값을 덮어씁니다. 따라서 이 함수들을 사용하여 맵 엔트리의 값을 업데이트할 수 있습니다.

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2)
    val previousValue = numbersMap.put("one", 11)
    println("'one'과 연결된 값, 이전: $previousValue, 이후: ${numbersMap["one"]}")
    println(numbersMap)
}

단축 연산자 형태를 사용하여 맵에 새로운 엔트리를 추가할 수도 있습니다. 두 가지 방법이 있습니다.

• 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)
}

맵에 존재하는 키와 함께 호출되면 연산자는 해당 엔트리의 값을 덮어씁니다.

누락된 엔트리에 대한 기본값 추가

기존 값을 반환하거나, 값이 없을 때 기본값을 추가하려면 .getOrPut() 확장 함수를 사용하세요. 키가 없거나 값이 null인 경우, .getOrPut()은 기본값을 저장하고 이를 반환합니다.

null이 될 수 있는 값을 가진 맵의 경우, .getOrPutIfNull() 및 .getOrPutIfMissing() 함수를 사용하여 null 값이 처리되는 방식을 제어할 수 있습니다.

• getOrPutIfNull()은 getOrPut()과 유사하게 작동하며, 키가 없거나 값이 null인 경우 기본값을 사용합니다.
• getOrPutIfMissing()은 키가 없는 경우에만 기본값을 사용합니다.

getOrPutIfNull() 및 getOrPutIfMissing() 함수는 실험적(Experimental)입니다. 이를 사용하려면 @OptIn(ExperimentalStdlibApi::class) 어노테이션을 사용하여 옵트인(opt-in)해야 합니다.

예제는 다음과 같습니다:

@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"이 맵에 존재하므로 null 값을 유지합니다.
    mapForMissing.getOrPutIfMissing("one") { 1 }

    println(mapForMissing)
    // {one=null}
}

엔트리 제거

가변 맵에서 엔트리를 제거하려면 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)
}

키나 값을 통해 가변 맵에서 엔트리를 제거할 수도 있습니다. 이를 위해 맵의 키(keys) 또는 값(values)에 대해 해당 엔트리의 키나 값을 제공하며 remove()를 호출하세요. 값에 대해 호출될 때, 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)
}

가변 맵에서는 minusAssign (-=) 연산자도 사용할 수 있습니다.

fun main() {
    val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
    numbersMap -= "two"
    println(numbersMap)
    numbersMap -= "five"             // 아무것도 제거되지 않음
    println(numbersMap)
}