# counter

线程安全的 `string → int64` 键值计数器，适合并发计数场景（按 key 累加/读取/覆盖）。

> 迁移自 go-hua/single 并更名：包 `single` → `counter`，类型 `Single` → `Counter`，
> 方法签名不变（Init/Get/Incr/Set）。

## 用法

```go
import (
    "sync"

    "git.zeroonesoft.cn/golib/zogo/counter"
)

var c counter.Counter
c.Init()

// 并发安全累加
var wg sync.WaitGroup
for i := 0; i < 100; i++ {
    wg.Add(1)
    go func() { defer wg.Done(); c.Incr("pv", 1) }()
}
wg.Wait()
c.Get("pv") // 100

// Set 覆盖并返回旧值
old := c.Set("pv", 0)
```

完整可运行例程：[examples/counter/main.go](../examples/counter/main.go)

## 注意

- **使用前必须 Init**，未初始化直接 `Incr/Set` 会 panic（nil map 写入）。
- 单实例内部持锁；跨实例无共享状态。