Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

cache

package module

Go to main page

Versions in this module

v1

v1.3.0

Jul 7, 2026

Changes in this version

+ const DefaultCleanupInterval

+ var ErrNotInteger = errors.New("cache: value is not an integer")

+ func GetAs[T any](c Cache, key string, def ...T) T

+ type LockStore interface

+ Add func(key string, value any, t time.Duration) bool

+ Forget func(key string) bool

+ ReleaseLock func(key, owner string) bool

type Memory

+ func (r *Memory) DeleteExpired()

+ func (r *Memory) ReleaseLock(key, owner string) bool

+ type Option func(*options)

+ func WithCleanupInterval(d time.Duration) Option

v1.2.0

Aug 1, 2025

Changes in this version

+ const NoExpiration

+ type Cache interface

+ Add func(key string, value any, t time.Duration) bool

+ Decrement func(key string, value ...int64) (int64, error)

+ Flush func() bool

+ Forever func(key string, value any) bool

+ Forget func(key string) bool

+ Get func(key string, def ...any) any

+ GetBool func(key string, def ...bool) bool

+ GetInt func(key string, def ...int) int

+ GetInt64 func(key string, def ...int64) int64

+ GetString func(key string, def ...string) string

+ Has func(key string) bool

+ Increment func(key string, value ...int64) (int64, error)

+ Lock func(key string, t ...time.Duration) *Lock

+ Pull func(key string, def ...any) any

+ Put func(key string, value any, t time.Duration) error

+ Remember func(key string, ttl time.Duration, callback func() (any, error)) (any, error)

+ RememberForever func(key string, callback func() (any, error)) (any, error)

+ WithContext func(ctx context.Context) Cache

+ func NewCache() Cache

+ type Lock struct

+ func NewLock(instance Cache, key string, t ...time.Duration) *Lock

+ func (r *Lock) Block(t time.Duration, callback ...func()) bool

+ func (r *Lock) ForceRelease() bool

+ func (r *Lock) Get(callback ...func()) bool

+ func (r *Lock) Release() bool

+ type Memory struct

+ func (r *Memory) Add(key string, value any, t time.Duration) bool

+ func (r *Memory) Decrement(key string, value ...int64) (int64, error)

+ func (r *Memory) Flush() bool

+ func (r *Memory) Forever(key string, value any) bool

+ func (r *Memory) Forget(key string) bool

+ func (r *Memory) Get(key string, def ...any) any

+ func (r *Memory) GetBool(key string, def ...bool) bool

+ func (r *Memory) GetInt(key string, def ...int) int

+ func (r *Memory) GetInt64(key string, def ...int64) int64

+ func (r *Memory) GetString(key string, def ...string) string

+ func (r *Memory) Has(key string) bool

+ func (r *Memory) Increment(key string, value ...int64) (int64, error)

+ func (r *Memory) Lock(key string, t ...time.Duration) *Lock

+ func (r *Memory) Pull(key string, def ...any) any

+ func (r *Memory) Put(key string, value any, t time.Duration) error

+ func (r *Memory) Remember(key string, seconds time.Duration, callback func() (any, error)) (any, error)

+ func (r *Memory) RememberForever(key string, callback func() (any, error)) (any, error)

+ func (r *Memory) WithContext(ctx context.Context) Cache