Documentation
¶
Index ¶
- func SetPanicHandler(fn func(any))
- type Map
- func (m *Map) Clone() *Map
- func (m *Map) Copy(from *Map, over bool) error
- func (m *Map) Del(key any)
- func (m *Map) Dels(keys []any)
- func (m *Map) ExpireAll()
- func (m *Map) Get(key any) any
- func (m *Map) GetHas(key any) (any, bool)
- func (m *Map) GetNewMap(key any) *Map
- func (m *Map) GetNewMaps(keys ...any) *Map
- func (m *Map) GetOrDefault(key any, def any) any
- func (m *Map) Has(key any) bool
- func (m *Map) Index(key ...any) any
- func (m *Map) IndexHas(keys ...any) (any, bool)
- func (m *Map) Keys() []any
- func (m *Map) Len() int
- func (m *Map) LoadAndDelete(key any) (any, bool)
- func (m *Map) LoadOrStore(key, val any) (actual any, loaded bool)
- func (m *Map) MarshalJSON() ([]byte, error)
- func (m *Map) New(key any) *Map
- func (m *Map) Range(f func(key, value any) bool)
- func (m *Map) ReadAll() any
- func (m *Map) ReadFrom(mm any) (err error)
- func (m *Map) Reset()
- func (m *Map) Set(key, val any)
- func (m *Map) SetExpired(key any, d time.Duration)
- func (m *Map) SetExpiredCall(key any, d time.Duration, f func(any))
- func (m *Map) String() (s string)
- func (m *Map) TTL(key any) (time.Duration, bool)
- func (m *Map) UnmarshalJSON(data []byte) error
- func (m *Map) Values() []any
- func (m *Map) WriteTo(mm any) (err error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func SetPanicHandler ¶ added in v2.4.0
func SetPanicHandler(fn func(any))
SetPanicHandler 设置过期回调 panic 的观测函数。fn 为 nil 时恢复静默。
Types ¶
type Map ¶
type Map struct {
// contains filtered or unexported fields
}
Map 是带 TTL 的 key-value 映射。TTL 可以在登记时指定,也可以在读取时指定。 禁止按值复制 Map(会复制锁且与源共享底层桶,并发写是 fatal)。请使用 *Map。
func NewMapSize ¶ added in v2.4.0
NewMapSize 预分配约 n 个键。n<=0 与 NewMap 相同。
func (*Map) Copy ¶
Copy 把 from 写入接收者。over 为 false 时不覆盖已存在的键。 nil、自拷贝直接返回。嵌套 *Map 和容器会深拷贝。 TTL 一律复制;deadline 已过但源定时器还没跑的键会马上过期,而不是变成永久键。
func (*Map) ExpireAll ¶ added in v2.4.2
func (m *Map) ExpireAll()
ExpireAll 终态关闭 Map。 停止所有定时器并在释放锁后异步触发已登记的有效清理回调。 彻底释放底层数据结构并置为已关闭状态。关闭后 Map 变为不可写入状态。
func (*Map) GetOrDefault ¶
GetOrDefault 键不存在时返回 def。键存在且值为 nil 时返回 nil。
func (*Map) IndexHas ¶
IndexHas 逐层读取。中间节点必须是非 nil *Map。
m1 := vmap.NewMap()
m2 := vmap.NewMap()
m2.Set("b", "value")
m1.Set("a", m2)
v, ok := m1.IndexHas("a", "b")
func (*Map) LoadAndDelete ¶ added in v2.4.0
LoadAndDelete 原子取出并删除。
func (*Map) LoadOrStore ¶ added in v2.4.0
LoadOrStore 键已存在则返回已有值,否则写入 val。
func (*Map) MarshalJSON ¶
MarshalJSON 转 JSON。只有键字符串冲突时才追加后缀,并保证后缀本身也不冲突。 encoding/json 会排序对象键,输出不依赖 map 遍历顺序。
func (*Map) ReadAll ¶
ReadAll 递归展开为 map[any]any。环引用写成占位字符串,避免栈溢出。不复制 TTL。 []*Map 保持原类型,避免旧的类型断言失效;[]any 会继续展开。
func (*Map) Reset ¶
func (m *Map) Reset()
Reset 静默清空所有键并停止定时器,不触发任何回调。 复用内部切片容量(不超过 shrinkMinCap),调用后 Map 仍处于可用状态。
func (*Map) SetExpired ¶
SetExpired 设置有效期。d==0 取消;键不存在则忽略。
func (*Map) SetExpiredCall ¶
SetExpiredCall 设置有效期。过期、到期前 Del、Close 时调用 f。 d==0 取消且不调用 f。d<0 立即过期并调用 f。f==nil 时保留旧回调。
func (*Map) UnmarshalJSON ¶
UnmarshalJSON 要求 JSON 对象。null 会清空。解析失败不修改接收者。