mirai-console/net.mamoe.mirai.console.data/PluginDataExtensions

PluginDataExtensions

object PluginDataExtensions

PluginData 相关一些扩展

Types

NotNullMap

@ConsoleExperimentalApi

open class NotNullMap<K, V> : Map<K, V>

NotNullMutableMap

class NotNullMutableMap<K, V> : PluginDataExtensions.NotNullMap<K, V> , MutableMap<K, V>

Functions

mapKeys

@JvmName(name = "mapKeysImmutable")

@JvmStatic

fun <OldK, NewK, V> SerializerAwareValue<Map<OldK, V>>.mapKeys(oldToNew: (OldK) -> NewK, newToOld: (NewK) -> OldK): SerializerAwareValue<Map<NewK, V>>

@JvmName(name = "mapKeysImmutableNotNull")

@JvmStatic

fun <OldK, NewK, V : Any> SerializerAwareValue<PluginDataExtensions.NotNullMap<OldK, V>>.mapKeys(oldToNew: (OldK) -> NewK, newToOld: (NewK) -> OldK): SerializerAwareValue<PluginDataExtensions.NotNullMap<NewK, V>>

替换 Map 的 key

@JvmName(name = "mapKeys")

@JvmStatic

fun <OldK, NewK, V> SerializerAwareValue<MutableMap<OldK, V>>.mapKeys(oldToNew: (OldK) -> NewK, newToOld: (NewK) -> OldK): SerializerAwareValue<MutableMap<NewK, V>>

@JvmName(name = "mapKeysNotNull")

@JvmStatic

fun <OldK, NewK, V : Any> SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<OldK, V>>.mapKeys(oldToNew: (OldK) -> NewK, newToOld: (NewK) -> OldK): SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<NewK, V>>

替换 MutableMap 的 key

withDefault

@JvmStatic

@JvmName(name = "withDefaultMapImmutable")

fun <K, V> SerializerAwareValue<Map<K, V>>.withDefault(defaultValueComputer: (K) -> V): SerializerAwareValue<Map<K, V>>

@JvmStatic

@JvmName(name = "withDefaultMapImmutableNotNull")

fun <K, V : Any> SerializerAwareValue<Map<K, V>>.withDefault(defaultValueComputer: (K) -> V): SerializerAwareValue<PluginDataExtensions.NotNullMap<K, V>>

@JvmStatic

@JvmName(name = "withDefaultMap")

fun <K, V> SerializerAwareValue<MutableMap<K, V>>.withDefault(defaultValueComputer: (K) -> V): SerializerAwareValue<MutableMap<K, V>>

创建一个代理对象, 当 Map.get 返回 null 时先调用 defaultValueComputer 并放入 Map, 再返回调用的返回值

@JvmStatic

@JvmName(name = "withDefaultMapNotNull")

fun <K, V : Any> SerializerAwareValue<MutableMap<K, V>>.withDefault(defaultValueComputer: (K) -> V): SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<K, V>>

withEmptyDefault

@JvmName(name = "withEmptyDefaultListImmutable")

@JvmStatic

fun <K, E> SerializerAwareValue<MutableMap<K, List<E>>>.withEmptyDefault(): SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<K, List<E>>>

@JvmName(name = "withEmptyDefaultList")

@JvmStatic

fun <K, E> SerializerAwareValue<MutableMap<K, MutableList<E>>>.withEmptyDefault(): SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<K, MutableList<E>>>

创建一个代理对象, 当 Map.get 返回 null 时先放入一个 ArrayList, 再从 this 中取出链接自动保存的 ArrayList.

@JvmName(name = "withEmptyDefaultMapImmutable")

@JvmStatic

fun <K, InnerE, InnerV> SerializerAwareValue<MutableMap<K, Map<InnerE, InnerV>>>.withEmptyDefault(): SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<K, Map<InnerE, InnerV>>>

@JvmName(name = "withEmptyDefaultMap")

@JvmStatic

fun <K, InnerE, InnerV> SerializerAwareValue<MutableMap<K, MutableMap<InnerE, InnerV>>>.withEmptyDefault(): SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<K, MutableMap<InnerE, InnerV>>>

创建一个代理对象, 当 Map.get 返回 null 时先放入一个 LinkedHashMap, 再从 this 中取出链接自动保存的 LinkedHashMap. (MutableMap.getOrPut 的替代)

@JvmName(name = "withEmptyDefaultSet")

@JvmStatic

fun <K, E> SerializerAwareValue<MutableMap<K, MutableSet<E>>>.withEmptyDefault(): SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<K, MutableSet<E>>>

@JvmName(name = "withEmptyDefaultSetImmutable")

@JvmStatic

fun <K, E> SerializerAwareValue<MutableMap<K, Set<E>>>.withEmptyDefault(): SerializerAwareValue<PluginDataExtensions.NotNullMutableMap<K, Set<E>>>

创建一个代理对象, 当 Map.get 返回 null 时先放入一个 LinkedHashSet, 再从 this 中取出链接自动保存的 LinkedHashSet.