常见 List 扩展函数及使用实例
将使用一个基础 Map 作为示例：val map = mapOf("a" to 1, "b" to 2, "c" to 3)。所有代码示例都基于这个 Map。
1. mapKeys 函数
- 函数签名 ：
fun <K, V, R> Map<out K, V>.mapKeys(transform: (Map.Entry<K, V>) -> R): Map<R, V> - 意思 ：转换 Map 的键（key），生成一个新 Map。新 Map 的键由
transform函数定义，值保持不变。 - 代码实例：将键转换为大写形式。
kotlin
val newMap = map.mapKeys { it.key.uppercase() }
println(newMap) // 输出: {A=1, B=2, C=3}2. mapValues 函数
- 函数签名 ：
fun <K, V, R> Map<out K, V>.mapValues(transform: (Map.Entry<K, V>) -> R): Map<K, R> - 意思 ：转换 Map 的值（value），生成一个新 Map。新 Map 的键保持不变，值由
transform函数定义。 - 代码实例：将值乘以 2。
kotlin
val newMap = map.mapValues { it.value * 2 }
println(newMap) // 输出: {a=2, b=4, c=6}3. filterKeys 函数
- 函数签名 ：
fun <K, V> Map<out K, V>.filterKeys(predicate: (K) -> Boolean): Map<K, V> - 意思 ：过滤 Map 的键，只保留满足
predicate条件的键值对，生成一个新 Map。 - 代码实例：只保留键以 "a" 开头的条目。
kotlin
val newMap = map.filterKeys { it.startsWith("a") }
println(newMap) // 输出: {a=1}4. filterValues 函数
- 函数签名 ：
fun <K, V> Map<out K, V>.filterValues(predicate: (V) -> Boolean): Map<K, V> - 意思 ：过滤 Map 的值，只保留满足
predicate条件的键值对，生成一个新 Map。 - 代码实例：只保留值大于 1 的条目。
kotlin
val newMap = map.filterValues { it > 1 }
println(newMap) // 输出: {b=2, c=3}5. filter 函数
- 函数签名 ：
fun <K, V> Map<out K, V>.filter(predicate: (Map.Entry<K, V>) -> Boolean): Map<K, V> - 意思 ：基于整个键值对（entry）进行过滤，只保留满足
predicate条件的条目，生成一个新 Map。比filterKeys或filterValues更灵活。 - 代码实例：只保留键长度大于 1 且值为奇数的条目。
kotlin
val newMap = map.filter { (key, value) -> key.length > 1 && value % 2 != 0 }
// 注意：示例 Map 的键都是单字符，所以这里可能无输出。实际使用时，可调整 Map。
val customMap = mapOf("apple" to 3, "banana" to 4)
val filteredMap = customMap.filter { (key, value) -> key.length > 5 && value % 2 == 0 }
println(filteredMap) // 输出: {banana=4}（如果键长度大于5且值为偶）6. getOrDefault 函数
- 函数签名 ：
fun <K, V> Map<out K, V>.getOrDefault(key: K, defaultValue: V): V - 意思：安全地获取值。如果键存在，则返回对应的值；如果键不存在，则返回指定的默认值。
- 代码实例：获取键 "d" 的值，如果不存在则返回 -1。
kotlin
val value = map.getOrDefault("d", -1)
println(value) // 输出: -1（因为 "d" 不在原始 Map 中）7. getOrElse 函数
- 函数签名 ：
fun <K, V> Map<out K, V>.getOrElse(key: K, defaultValue: () -> V): V - 意思 ：安全地获取值。如果键存在，则返回对应的值；如果键不存在，则计算并返回由
defaultValue函数生成的值。比getOrDefault更灵活，因为默认值可以动态计算。 - 代码实例：获取键 "d" 的值，如果不存在则计算默认值（例如，字符串长度）。
kotlin
val value = map.getOrElse("d") { "default".length } // 默认值计算为 7
println(value) // 输出: 78. plus 操作符（扩展函数形式）
- 函数签名 ：
operator fun <K, V> Map<out K, V>.plus(pair: Pair<K, V>): Map<K, V>（也支持多个 Pair 或 Map） - 意思 ：添加一个或多个键值对，生成一个新 Map。原始 Map 不变。使用
+操作符调用。 - 代码实例：添加一个新键值对 "d" to 4。
kotlin
val newMap = map + ("d" to 4)
println(newMap) // 输出: {a=1, b=2, c=3, d=4}9. minus 操作符（扩展函数形式）
- 函数签名 ：
operator fun <K, V> Map<out K, V>.minus(key: K): Map<K, V>（也支持多个键） - 意思 ：移除一个或多个键值对，生成一个新 Map。原始 Map 不变。使用
-操作符调用。 - 代码实例：移除键 "b"。
kotlin
val newMap = map - "b"
println(newMap) // 输出: {a=1, c=3}10. forEach 函数
- 函数签名 ：
fun <K, V> Map<out K, V>.forEach(action: (Map.Entry<K, V>) -> Unit) - 意思 ：遍历 Map 的每个键值对，执行
action操作。无返回值，用于副作用（如打印）。 - 代码实例：打印每个键值对。
kotlin
map.forEach { (key, value) -> println("Key: $key, Value: $value") }
// 输出:
// Key: a, Value: 1
// Key: b, Value: 2
// Key: c, Value: 311. onEach 函数
- 函数签名 ：
fun <K, V> Map<out K, V>.onEach(action: (Map.Entry<K, V>) -> Unit): Map<K, V> - 意思 ：遍历 Map 的每个键值对，执行
action操作，并返回原始 Map。常用于链式调用中执行中间操作。 - 代码实例：打印每个条目后，返回原始 Map 进行后续操作。
kotlin
val processedMap = map.onEach { println("Processing: ${it.key}") }
.mapValues { it.value * 10 }
println(processedMap) // 输出: {a=10, b=20, c=30}，同时打印处理过程