Map

取键与值
过滤
加减操作
Map 写操作
- 添加与更新条目
- 删除条目

在 map 中，键和值的类型都是用户定义的。对基于键的访问启用了各种特定于 map 的处理函数，从键获取值到对键和值进行单独过滤

取键与值

要从 Map 中检索值，必须提供其键作为 get() 函数的参数。还支持简写 [key] 语法。如果找不到给定的键，则返回 null
函数 getValue() ，它的行为略有不同：如果在 Map 中找不到键，则抛出异常

此外，还有两个选项可以解决键缺失的问题：

getOrElse() 与 list 的工作方式相同：对于不存在的键，其值由给定的 lambda 表达式返回
getOrDefault() 如果找不到键，则返回指定的默认值

fun main() {
//sampleStart
    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!
//sampleEnd
}

要对 map 的所有键或所有值执行操作，可以从属性 keys 和 values 中相应地检索它们：

keys 是 Map 中所有键的集合
values 是 Map 中所有值的集合

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

过滤

可以使用 filter() 函数来过滤 map 或其他集合。对 map 使用 filter() 函数时， Pair 将作为参数的谓词传递给它。它将使用谓词同时过滤其中的键和值：

fun main() {
//sampleStart
    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)
//sampleEnd
}

还有两种用于过滤 map 的特定函数：按键或按值。对应的函数： filterKeys() 和 filterValues() ，两者都将返回一个新 Map ，其中包含与给定谓词相匹配的条目：

filterKeys() 的谓词仅检查元素键
filterValues() 的谓词仅检查值

fun main() {
//sampleStart
    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)
//sampleEnd
}

加减操作

由于需要访问元素的键，plus + 与 minus - 运算符对 map 的作用与其他集合不同。 plus 返回包含两个操作数元素的 Map ：

左侧 Map
右侧 Pair 或另一个 Map
- 当右侧操作数中有左侧 Map 中已存在的键时，该条目将使用右侧的值

fun main() {
//sampleStart
    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))
//sampleEnd
}

minus 将根据左侧 Map 条目创建一个新 Map ，右侧操作数带有键的条目将被剔除

右侧操作数可以是单个键或键的集合： list 、 set 等

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

    可变 Map 中使用 plusAssign (+=) 与 minusAssign (-=) 运算符

Map 写操作

Mutable Map （可变 Map ）提供特定的 Map 写操作。这些操作可以使用键来访问或更改 Map 值。Map 写操作的一些规则：

值可以更新。反过来，键也永远不会改变：添加条目后，键是不变的
每个键都有一个与之关联的值。也可以添加和删除整个条目

添加与更新条目

要将新的键值对添加到可变 Map ，请使用 put()

     新条目会被放入 LinkedHashMap （Map的默认实现）后，会添加该条目，以便在 Map 迭代时排在最后

     在 Map 类中，新元素的位置由其键顺序定义

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

要一次添加多个条目，请使用 putAll() 。它的参数可以是 Map 或一组 Pair ： Iterable 、 Sequence 或 Array

fun main() {
//sampleStart
    val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
    numbersMap.putAll(setOf("four" to 4, "five" to 5))
    println(numbersMap)
//sampleEnd
}

如果给定键已存在于 Map 中，则 put() 与 putAll() 都将覆盖值。因此，可以使用它们来更新 Map 条目的值

fun main() {
//sampleStart
    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)
//sampleEnd
}

还可以使用快速操作符将新条目添加到 Map 。有两种方式：

plusAssign += 操作符
[] 操作符为 put() 的别名

fun main() {
//sampleStart
    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)
//sampleEnd
}

使用 Map 中存在的键进行操作时，将覆盖相应条目的值

删除条目

要从可变 Map 中删除条目，请使用 remove() 函数。调用 remove() 时，可以传递键或整个键值对。如果同时指定键和值，则仅当键值都匹配时，才会删除此的元素

fun main() {
//sampleStart
    val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
    numbersMap.remove("one")
    println(numbersMap)
    numbersMap.remove("three", 4)            //不会删除任何条目
    println(numbersMap)
//sampleEnd
}

还可以通过键或值从可变 Map 中删除条目。在 Map 的 .keys 或 .values 中调用 remove() 并提供键或值来删除条目

在 .values 中调用时， remove() 仅删除给定值匹配到的的 第一个 条目

fun main() {
//sampleStart
    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)
//sampleEnd
}

minusAssign -= 操作符也可用于可变 Map

fun main() {
//sampleStart
    val numbersMap = mutableMapOf("one" to 1, "two" to 2, "three" to 3)
    numbersMap -= "two"
    println(numbersMap)
    numbersMap -= "five"             //不会删除任何条目
    println(numbersMap)
//sampleEnd
}

Previous: Set

Home：集合

Map

Table of Contents

取键与值

过滤

加减操作

Map 写操作

添加与更新条目

删除条目