一、前言:
在 map 中,键和值的类型都是用户定义的。 对基于键的访问启用了各种特定于 map 的处理函数,从键获取值到对键和值进行单独过滤。 在此页面上,我们提供了来自标准库的 map 处理功能的描述。
1、取键与值
要从 Map 中检索值,必须提供其键作为 get()
函数的参数。 还支持简写 [key]
语法。 如果找不到给定的键,则返回 null
。 还有一个函数 getValue()
,它的行为略有不同:如果在 Map 中找不到键,则抛出异常。 此外,还有两个选项可以解决键缺失的问题:
-
getOrElse()
与 list 的工作方式相同:对于不存在的键,其值由给定的 lambda 表达式返回。 -
getOrDefault()
如果找不到键,则返回指定的默认值。
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") // exception!
要对 map 的所有键或所有值执行操作,可以从属性 keys 和 values 中相应地检索它们。 keys 是 Map 中所有键的集合, values 是 Map 中所有值的集合。
val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
println(numbersMap.keys)
println(numbersMap.values)
2、过滤
可以使用 filter()
函数来过滤 map 或其他集合。 对 map 使用 filter()
函数时, Pair
将作为参数的谓词传递给它。 它将使用谓词同时过滤其中的键和值。
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()
的谓词仅检查值。
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)
3、 plus
与 minus
操作
由于需要访问元素的键,plus
(+
)与 minus
(-
)运算符对 map 的作用与其他集合不同。 plus
返回包含两个操作数元素的 Map
:左侧的 Map 与右侧的 Pair 或另一个 Map 。 当右侧操作数中有左侧 Map
中已存在的键时,该条目将使用右侧的值。
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 等。
val numbersMap = mapOf("one" to 1, "two" to 2, "three" to 3)
println(numbersMap - "one")
println(numbersMap - listOf("two", "four"))
4、 添加与更新条目
要将新的键值对添加到可变 Map ,请使用 put()
。 将新条目放入 LinkedHashMap
(Map的默认实现)后,会添加该条目,以便在 Map 迭代时排在最后。 在 Map 类中,新元素的位置由其键顺序定义。
val numbersMap = mutableMapOf("one" to 1, "two" to 2)
numbersMap.put("three", 3)
println(numbersMap)
要一次添加多个条目,请使用 putAll()
。它的参数可以是 Map
或一组 Pair
: Iterable
、 Sequence
或 Array
。
val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
numbersMap.putAll(setOf("four" to 4, "five" to 5))
println(numbersMap)
如果给定键已存在于 Map 中,则 put() 与 putAll() 都将覆盖值。 因此,可以使用它们来更新 Map 条目的值。
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()
的别名。
val numbersMap = mutableMapOf("one" to 1, "two" to 2)
numbersMap["three"] = 3 // 调用 numbersMap.set("three", 3)
numbersMap += mapOf("four" to 4, "five" to 5)
println(numbersMap)
使用 Map 中存在的键进行操作时,将覆盖相应条目的值。
5、 删除条目
要从可变 Map 中删除条目,请使用 remove()
函数。 调用 remove()
时,可以传递键或整个键值对。 如果同时指定键和值,则仅当键值都匹配时,才会删除此的元素。
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() 仅删除给定值匹配到的的第一个条目。
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
(-=
) 操作符也可用于可变 Map 。
val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
numbersMap -= "two"
println(numbersMap)
numbersMap -= "five" //不会删除任何条目
println(numbersMap)