HMap - 并发安全的泛型Map

January 22, 2025 · View on GitHub

HMap - 并发安全的泛型Map

English	中文

HMap 是一个并发安全的支持泛型的Map实现，旨在提供简单易用的 API，支持泛型键值对，同时添加了对映射长度的查询以及清空映射的方法。

特性

泛型支持: 使用 Golang 的泛型特性，可以在不同类型的键值对上使用 HMap。
映射长度查询: 通过 Len 方法快速获取映射的长度。
清空映射: 使用 Clean 方法轻松清空整个映射。

Go版本

>= 1.20

快速开始

使用 `Map`

Map 是一个基于互斥锁的并发安全 Map 实现。

package main

import (
	"fmt"
	"github.com/lyonnee/hmap"
)

func main() {
	// 创建一个新的 Map 实例
	myMap := hmap.NewMap[string, int](10)

	// 存储键值对
	myMap.Store("key1", 1)
	myMap.Store("key2", 2)

	// 查询 Map 的长度
	length := myMap.Len()
	fmt.Printf("Map Length: %d\n", length)

	// 清空 Map
	myMap.Clean()

	// 查询清空后的 Map 长度
	length = myMap.Len()
	fmt.Printf("Map Length after Clean: %d\n", length)
}

使用 `SyncMap`

SyncMap 是一个基于 sync.Map 的并发安全 Map 实现。

package main

import (
	"fmt"
	"github.com/lyonnee/hmap"
)

func main() {
	// 创建一个新的 SyncMap 实例
	mySyncMap := hmap.NewSyncMap[string, int]()

	// 存储键值对
	mySyncMap.Store("key1", 1)
	mySyncMap.Store("key2", 2)

	// 查询 Map 的长度
	length := mySyncMap.Len()
	fmt.Printf("SyncMap Length: %d\n", length)

	// 清空 Map
	mySyncMap.Clean()

	// 查询清空后的 Map 长度
	length = mySyncMap.Len()
	fmt.Printf("SyncMap Length after Clean: %d\n", length)
}