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

memcache

package

Go to main page

Versions in this module

v1

v1.0.1

Feb 4, 2026

Changes in this version

type Client

+ func NewWithConfig(config *Config) (*Client, error)

+ func (c *Client) Config() *Config

+ func (c *Client) Reset()

+ func (c *Client) Stat() *Stat

+ type Config struct

+ AfterConnect func(context.Context, net.Conn) error

+ AfterRelease func(net.Conn) bool

+ BeforeAcquire func(context.Context, net.Conn) bool

+ BeforeClose func(net.Conn)

+ BeforeConnect func(context.Context, net.Addr) error

+ HealthCheckPeriod time.Duration

+ MaxConnIdleTime time.Duration

+ MaxConnLifetime time.Duration

+ MaxConnLifetimeJitter time.Duration

+ MaxConns int32

+ MinConns int32

+ Servers []string

+ Timeout time.Duration

+ func NewConfig(servers ...string) *Config

+ func (c *Config) Copy() *Config

type ConnectTimeoutError

+ Timeout time.Duration

+ type Stat struct

+ func (s *Stat) AcquireCount() int64

+ func (s *Stat) AcquireDuration() time.Duration

+ func (s *Stat) AcquiredConns() int32

+ func (s *Stat) CanceledAcquireCount() int64

+ func (s *Stat) ConstructingConns() int32

+ func (s *Stat) EmptyAcquireCount() int64

+ func (s *Stat) IdleConns() int32

+ func (s *Stat) MaxConns() int32

+ func (s *Stat) MaxIdleDestroyCount() int64

+ func (s *Stat) MaxLifetimeDestroyCount() int64

+ func (s *Stat) NewConnsCount() int64

+ func (s *Stat) TotalConns() int32

v1.0.0

Jan 3, 2026

Changes in this version

+ const DefaultMaxIdleConns

+ const DefaultTimeout

+ var ErrCASConflict = errors.New("memcache: compare-and-swap conflict")

+ var ErrCacheMiss = errors.New("memcache: cache miss")

+ var ErrClusterConfigMiss = errors.New("memcache: cluster config miss")

+ var ErrCorruptGetResult = errors.New("memcache: corrupt get result read")

+ var ErrInvalidConfig = errors.New("memcache: invalid cluster config found")

+ var ErrInvalidPollingDuration = errors.New("memcache: discovery polling duration is invalid")

+ var ErrMalformedKey = errors.New("malformed: key is too long or contains invalid characters")

+ var ErrNoConfig = errors.New("memcache: no cluster config found")

+ var ErrNoServers = errors.New("memcache: no servers configured or available")

+ var ErrNoStats = errors.New("memcache: no statistics available")

+ var ErrNotStored = errors.New("memcache: item not stored")

+ var ErrServerError = errors.New("memcache: server error")

+ type Client struct

+ MaxIdleConns int

+ StopPolling stop

+ Timeout time.Duration

+ func New(server ...string) (*Client, error)

+ func NewDiscoveryClient(discoveryAddress string, pollingDuration time.Duration) (*Client, error)

+ func NewFromSelector(ss ServerSelector) *Client

+ func (c *Client) Add(item *Item) error

+ func (c *Client) Append(item *Item) error

+ func (c *Client) Close() error

+ func (c *Client) CompareAndSwap(item *Item) error

+ func (c *Client) Decrement(key []byte, delta uint64) (newValue uint64, err error)

+ func (c *Client) Delete(key []byte) error

+ func (c *Client) DeleteAll() error

+ func (c *Client) FlushAll() error

+ func (c *Client) Get(key []byte) (item *Item, err error)

+ func (c *Client) GetAndTouch(key []byte, expiration int32) (item *Item, err error)

+ func (c *Client) GetAndTouchWithItem(key []byte, expiration int32, item *Item) error

+ func (c *Client) GetConfig(configType string) (clusterConfig *ClusterConfig, err error)

+ func (c *Client) GetMulti(keys [][]byte) (map[string]*Item, error)

+ func (c *Client) GetWithItem(key []byte, item *Item) error

+ func (c *Client) Increment(key []byte, delta uint64) (newValue uint64, err error)

+ func (c *Client) Ping() error

+ func (c *Client) Prepend(item *Item) error

+ func (c *Client) Replace(item *Item) error

+ func (c *Client) Set(item *Item) error

+ func (c *Client) Touch(key []byte, seconds int32) (err error)

+ type ClusterConfig struct

+ ConfigID int64

+ NodeAddresses []ClusterNode

+ type ClusterNode struct

+ Host string

+ Port int64

+ type ConnectTimeoutError struct

+ Addr net.Addr

+ func (cte *ConnectTimeoutError) Error() string

+ type Item struct

+ CasID uint64

+ Expiration int32

+ Flags uint32

+ Key []byte

+ Value []byte

+ func (it *Item) Reset()

+ type ServerList struct

+ func (ss *ServerList) Each(f func(net.Addr) error) error

+ func (ss *ServerList) PickAnyServer() (net.Addr, error)

+ func (ss *ServerList) PickServer(key []byte) (net.Addr, error)

+ func (ss *ServerList) SetServers(servers ...string) error

+ type ServerSelector interface

+ Each func(func(net.Addr) error) error

+ PickAnyServer func() (net.Addr, error)

+ PickServer func(key []byte) (net.Addr, error)