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
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.0.6

Dec 19, 2025

v1.0.5

Dec 18, 2025

Changes in this version

type LoadingCache

+ RefreshIfModifiedAfter func(Key, time.Time)

v1.0.4

Apr 25, 2024

v1.0.3

Mar 27, 2024

Changes in this version

type LoadingCache

+ GetActive func(Key) (Value, error)

v1.0.2

Jul 29, 2022

Changes in this version

type Cache

+ GetAll func() map[interface{}]interface{}

+ GetAllKeys func() []interface{}

+ GetAllValues func() []interface{}

+ Size func() int

type LoadingCache

+ Refresh func(Key)

type Option

+ func WithExpireAfterWrite(d time.Duration) Option

+ func WithReloader(reloader Reloader) Option

+ type Reloader interface

+ Close func() error

+ Reload func(key Key, oldValue Value, setFunc func(Value, error))

v0

v0.1.0

Nov 2, 2017

Changes in this version

+ type Cache interface

+ Close func() error

+ GetIfPresent func(Key) (Value, bool)

+ Invalidate func(Key)

+ InvalidateAll func()

+ Put func(Key, Value)

+ Stats func(*Stats)

+ func New(options ...Option) Cache

+ type Func func(Key, Value)

+ type Hash interface

+ Sum64 func() uint64

+ type Key interface

+ type LoaderFunc func(Key) (Value, error)

+ type LoadingCache interface

+ Get func(Key) (Value, error)

+ func NewLoadingCache(loader LoaderFunc, options ...Option) LoadingCache

+ type Option func(c *localCache)

+ func WithExpireAfterAccess(d time.Duration) Option

+ func WithMaximumSize(size int) Option

+ func WithPolicy(name string) Option

+ func WithRefreshAfterWrite(d time.Duration) Option

+ func WithRemovalListener(onRemoval Func) Option

+ func WithStatsCounter(st StatsCounter) Option

+ type Stats struct

+ EvictionCount uint64

+ HitCount uint64

+ LoadErrorCount uint64

+ LoadSuccessCount uint64

+ MissCount uint64

+ TotalLoadTime time.Duration

+ func (s *Stats) AverageLoadPenalty() time.Duration

+ func (s *Stats) HitRate() float64

+ func (s *Stats) LoadErrorRate() float64

+ func (s *Stats) MissRate() float64

+ func (s *Stats) RequestCount() uint64

+ func (s *Stats) String() string

+ type StatsCounter interface

+ RecordEviction func()

+ RecordHits func(count uint64)

+ RecordLoadError func(loadTime time.Duration)

+ RecordLoadSuccess func(loadTime time.Duration)

+ RecordMisses func(count uint64)

+ Snapshot func(*Stats)

+ type Value interface