README
¶
vmap 
golang Map，go Map, 可多线程安全读写，内部封装于 sync.Map。
列表：
type Map struct {} // Map结构
func NewMap() *Map // Map对象
func (m *Map) New(key interface{}) *Map // 新建一个key对应的Map对象，并返回该Map
func (m *Map) GetNewMap(key interface{}) *Map // 如果不存在增加一个key对应的Map对象，否则读取并返回该对象。(一次单个）
func (m *Map) GetNewMaps(keys ...interface{}) *Map // 如果不存在增加一个key对应的Map对象，否则读取并返回该对象。(一次多个)
func (m *Map) Len() int // 长度
func (m *Map) Set(key, val interface{}) // 设置
func (m *Map) SetExpired(key interface{}, d time.Duration) // 设置KEY有效期，过期会自动删除
func (m *Map) SetExpiredCall(key interface{}, d time.Duration, f func(interface{})) // 设置KEY有效期，过期会自动删除，并调用函数
func (m *Map) Get(key interface{}) interface{} // 读取
func (m *Map) Has(key interface{}) bool // 判断
func (m *Map) GetOrDefault(key interface{}, def interface{}) interface{} //读取，没有返回默认值
func (m *Map) GetHas(key interface{}) (val interface{}, ok bool) // 读取并判断
func (m *Map) Index(key ...interface{}) interface{} // 快速索引
func (m *Map) IndexHas(key ...interface{}) (interface{}, bool) // 快速索引+判断
func (m *Map) Del(key interface{}) // 删除
func (m *Map) Dels(key []interface{}) // 批量删除
func (m *Map) ReadAll() interface{} // 读取所有
func (m *Map) Range(f func(key, value interface{}) bool) // 遍历，返回true继续，否则退出
func (m *Map) Keys() []interface{} // Map中的所有键名
func (m *Map) Values() []interface{} // Map中的所有值
func (m *Map) Reset() // 重置
func (m *Map) Copy(from *Map) // 复制，从 from 复制写入到m
func (m *Map) MarshalJSON() ([]byte, error) // 编码JSON
func (m *Map) UnmarshalJSON(data []byte) error // 解码JSON
func (m *Map) WriteTo(mm interface{}) (err error) // 写入到 mm
func (m *Map) ReadFrom(mm interface{}) error // 从 mm 读取
func (m *Map) String() string // 字符串
Documentation
¶
Index ¶
- type Map
- func (T *Map) Copy(from *Map, over bool)
- func (T *Map) Del(key any)
- func (T *Map) Dels(keys []any)
- func (T *Map) Get(key any) any
- func (T *Map) GetHas(key any) (val any, ok bool)
- func (T *Map) GetNewMap(key any) *Map
- func (T *Map) GetNewMaps(keys ...any) *Map
- func (T *Map) GetOrDefault(key any, def any) any
- func (T *Map) Has(key any) bool
- func (T *Map) Index(key ...any) any
- func (T *Map) IndexHas(key ...any) (any, bool)
- func (T *Map) Keys() []any
- func (T *Map) Len() int
- func (T *Map) MarshalJSON() ([]byte, error)
- func (T *Map) New(key any) *Map
- func (T *Map) Range(f func(key, value any) bool)
- func (T *Map) ReadAll() any
- func (T *Map) ReadFrom(mm any) error
- func (T *Map) Reset()
- func (T *Map) Set(key, val any)
- func (T *Map) SetExpired(key any, d time.Duration)
- func (T *Map) SetExpiredCall(key any, d time.Duration, f func(any))
- func (T *Map) String() string
- func (T *Map) UnmarshalJSON(data []byte) error
- func (T *Map) Values() []any
- func (T *Map) WriteTo(mm any) (err error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Map ¶
type Map struct {
// contains filtered or unexported fields
}
Map 推荐使用NewMap来规范的创建，这样可避免不必要的错误。
func (*Map) GetNewMaps ¶
GetNewMaps 如果不存在增加一个key对应的Map对象，否则读取并返回该对象。 他支持链式读取或创建，如果你想相独读取，可以使用 .Index 方法
key ...any 键名 *Map Map对象
func (*Map) Index ¶
Index 指定读取，这个仅能使用于 *Map 中有子 *Map。功能用于快速索引定位。
参：
key ...any 快速指定父子关系中的值，如 .Index("A", "B", "C")
返：
any 读取值
func (*Map) IndexHas ¶
IndexHas 指定读取和判断，这个只有使用于 *Map 中有子 *Map。功能用于快速索引定位。
key ...any 快速指定父子关系中的值，如 .Index("A", "B", "C")
any 读取值
bool 判断，如果为true，表示存在。否则为flase
例：
m1 := birdswo.NewMap()
m2 := birdswo.NewMap()
m2.Set("b", "value")
m1.Set("a", m2)
v, ok := m1.IndexHas("a", "b")
fmt.Println(v, ok)
//value true
func (*Map) New ¶
New 增加一个key对应的Map对象，并返回该对象。 .New 不管是否存在该 key 键值，都会写入一个新的Map覆盖 key 键值。 要是你需要一个这样的功能，存在key键值，返回该key键值。如果不存在该key键值，返回一个新的key对应的Map。请使用 .GetNewMap 方法
key any 键名 *Map Map对象
func (*Map) SetExpiredCall ¶
SetExpiredCall 单个键值的有效期，过期后并调用函数
key any 键名 d time.Duration 时间 f func(interface) 函数,过期调用，键删除调用
func (*Map) UnmarshalJSON ¶
UnmarshalJSON JSON转Map，格式需要是 map[string]any
data []byte 字节格式的json error 错误，格式无法解压，导致 json.Unmarshal 发生错误。
Source Files
Click to show internal directories.
Click to hide internal directories.