gf/g/container/gmap/gmap_string_bool_map.go

// Copyright 2017 gf Author(https://github.com/gogf/gf). All Rights Reserved.
//
// This Source Code Form is subject to the terms of the MIT License.
// If a copy of the MIT was not distributed with gm file,
// You can obtain one at https://github.com/gogf/gf.
//

package gmap

import (
	"github.com/gogf/gf/g/internal/rwmutex"
)

type StringBoolMap struct {
	mu *rwmutex.RWMutex
	m  map[string]bool
}

func NewStringBoolMap(unsafe...bool) *StringBoolMap {
	return &StringBoolMap{
		m  : make(map[string]bool),
		mu : rwmutex.New(unsafe...),
	}
}

func NewStringBoolMapFrom(m map[string]bool, unsafe...bool) *StringBoolMap {
    return &StringBoolMap{
        m  : m,
        mu : rwmutex.New(unsafe...),
    }
}

func NewStringBoolMapFromArray(keys []string, values []bool, unsafe...bool) *StringBoolMap {
    m := make(map[string]bool)
    l := len(values)
    for i, k := range keys {
        if i < l {
            m[k] = values[i]
        } else {
            m[k] = false
        }
    }
    return &StringBoolMap{
        m  : m,
        mu : rwmutex.New(unsafe...),
    }
}

// 给定回调函数对原始内容进行遍历，回调函数返回true表示继续遍历，否则停止遍历
func (gm *StringBoolMap) Iterator(f func (k string, v bool) bool) {
	gm.mu.RLock()
	defer gm.mu.RUnlock()
    for k, v := range gm.m {
		if !f(k, v) {
			break
		}
    }
}

// 哈希表克隆.
func (gm *StringBoolMap) Clone() *StringBoolMap {
    return NewStringBoolMapFrom(gm.Map(), !gm.mu.IsSafe())
}

// 返回当前哈希表的数据Map.
func (gm *StringBoolMap) Map() map[string]bool {
    m := make(map[string]bool)
    gm.mu.RLock()
    for k, v := range gm.m {
        m[k] = v
    }
    gm.mu.RUnlock()
    return m
}

// 设置键值对
func (gm *StringBoolMap) Set(key string, val bool) {
	gm.mu.Lock()
	gm.m[key] = val
	gm.mu.Unlock()
}

// 批量设置键值对
func (gm *StringBoolMap) BatchSet(m map[string]bool) {
    gm.mu.Lock()
    for k, v := range m {
        gm.m[k] = v
    }
    gm.mu.Unlock()
}

// 获取键值
func (gm *StringBoolMap) Get(key string) bool {
	gm.mu.RLock()
	val, _ := gm.m[key]
	gm.mu.RUnlock()
	return val
}

// 设置kv缓存键值对，内部会对键名的存在性使用写锁进行二次检索确认，如果存在则不再写入；返回键名对应的键值。
// 在高并发下有用，防止数据写入的并发逻辑错误。
func (gm *StringBoolMap) doSetWithLockCheck(key string, value bool) bool {
	gm.mu.Lock()
	if v, ok := gm.m[key]; ok {
		gm.mu.Unlock()
		return v
	}
	gm.m[key] = value
	gm.mu.Unlock()
	return value
}

// 当键名存在时返回其键值，否则写入指定的键值
func (gm *StringBoolMap) GetOrSet(key string, value bool) bool {
	gm.mu.RLock()
	v, ok := gm.m[key]
	gm.mu.RUnlock()
	if !ok {
		return gm.doSetWithLockCheck(key, value)
	} else {
		return v
	}
}

// 当键名存在时返回其键值，否则写入指定的键值，键值由指定的函数生成
func (gm *StringBoolMap) GetOrSetFunc(key string, f func() bool) bool {
	gm.mu.RLock()
	v, ok := gm.m[key]
	gm.mu.RUnlock()
	if !ok {
		return gm.doSetWithLockCheck(key, f())
	} else {
		return v
	}
}

// 与GetOrSetFunc不同的是，f是在写锁机制内执行
func (gm *StringBoolMap) GetOrSetFuncLock(key string, f func() bool) bool {
	gm.mu.RLock()
	val, ok := gm.m[key]
	gm.mu.RUnlock()
	if !ok {
		gm.mu.Lock()
		defer gm.mu.Unlock()
		if v, ok := gm.m[key]; ok {
			gm.mu.Unlock()
			return v
		}
		val         = f()
		gm.m[key] = val
		return val
	} else {
		return val
	}
}

// 当键名不存在时写入，并返回true；否则返回false。
func (gm *StringBoolMap) SetIfNotExist(key string, value bool) bool {
	if !gm.Contains(key) {
		gm.doSetWithLockCheck(key, value)
		return true
	}
	return false
}

// 批量删除键值对
func (gm *StringBoolMap) BatchRemove(keys []string) {
    gm.mu.Lock()
    for _, key := range keys {
        delete(gm.m, key)
    }
    gm.mu.Unlock()
}

// 返回对应的键值，并删除该键值
func (gm *StringBoolMap) Remove(key string) bool {
	gm.mu.Lock()
	val, exists := gm.m[key]
	if exists {
		delete(gm.m, key)
	}
	gm.mu.Unlock()
	return val
}

// 返回键列表
func (gm *StringBoolMap) Keys() []string {
	gm.mu.RLock()
	keys := make([]string, 0)
	for key, _ := range gm.m {
		keys = append(keys, key)
	}
    gm.mu.RUnlock()
	return keys
}

// 返回值列表(注意是随机排序)
//func (gm *StringBoolMap) Values() []bool {
//	gm.mu.RLock()
//	vals := make([]bool, 0)
//	for _, val := range gm.m {
//		vals = append(vals, val)
//	}
//	gm.mu.RUnlock()
//	return vals
//}

// 是否存在某个键
func (gm *StringBoolMap) Contains(key string) bool {
	gm.mu.RLock()
	_, exists := gm.m[key]
	gm.mu.RUnlock()
	return exists
}

// 哈希表大小
func (gm *StringBoolMap) Size() int {
	gm.mu.RLock()
	length := len(gm.m)
	gm.mu.RUnlock()
	return length
}

// 哈希表是否为空
func (gm *StringBoolMap) IsEmpty() bool {
	gm.mu.RLock()
	empty := len(gm.m) == 0
	gm.mu.RUnlock()
	return empty
}

// 清空哈希表
func (gm *StringBoolMap) Clear() {
    gm.mu.Lock()
    gm.m = make(map[string]bool)
    gm.mu.Unlock()
}

// 并发安全锁操作，使用自定义方法执行加锁修改操作
func (gm *StringBoolMap) LockFunc(f func(m map[string]bool)) {
	gm.mu.Lock()
	defer gm.mu.Unlock()
	f(gm.m)
}

// 并发安全锁操作，使用自定义方法执行加锁读取操作
func (gm *StringBoolMap) RLockFunc(f func(m map[string]bool)) {
	gm.mu.RLock()
	defer gm.mu.RUnlock()
	f(gm.m)
}

// 合并两个Map.
func (gm *StringBoolMap) Merge(m *StringBoolMap) {
	gm.mu.Lock()
	defer gm.mu.Unlock()
	if m != gm {
		m.mu.RLock()
		defer m.mu.RUnlock()
	}
	for k, v := range m.m {
		gm.m[k] = v
	}
}