맵 관련 연산

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

키와 값 검색

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

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

fun main() {
    val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
    println(numbersMap.get("one"))
    println(numbersMap["one"])
    println(numbersMap.getOrDefault("four", 10))
    println(numbersMap["five"])               // null
    //numbersMap.getValue("six")      // 예외 발생!
}

맵의 모든 키 또는 모든 값에 대해 연산을 수행하려면 각각 keys 및 values 속성에서 가져올 수 있습니다. keys는 모든 맵 키의 집합이며 values는 모든 맵 값의 컬렉션입니다.

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

필터링

다른 컬렉션과 마찬가지로 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(기본 맵 구현체)에 삽입되면, 맵을 순회할 때 마지막에 오도록 추가됩니다. 정렬된 맵에서는 새 요소의 위치는 키의 순서에 따라 정의됩니다.

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

한 번에 여러 엔트리를 추가하려면 putAll()을 사용하세요. 해당 인수는 Map 또는 Pair 그룹( Iterable, Sequence 또는 Array)일 수 있습니다.

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("value associated with 'one', before: $previousValue, after: ${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)
}

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

엔트리 제거

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

맵의 키 또는 값을 기준으로 가변 맵에서 엔트리를 제거할 수도 있습니다. 이를 위해 엔트리의 키 또는 값을 제공하여 맵의 키 또는 값에 대해 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)
}