imcache

Jan 17, 2024

Changes in this version

type Cache

+ func (c *Cache[K, V]) Peek(key K) (V, bool)

+ func (c *Cache[K, V]) PeekAll() map[K]V

+ func (c *Cache[K, V]) PeekMultiple(keys ...K) map[K]V

+ type EvictionPolicy int32

+ const EvictionPolicyLFU

+ const EvictionPolicyLRU

+ const EvictionPolicyRandom

type Option

+ func WithMaxEntriesLimitOption[K comparable, V any](limit int, policy EvictionPolicy) Option[K, V]

type Sharded

+ func (s *Sharded[K, V]) Peek(key K) (V, bool)

+ func (s *Sharded[K, V]) PeekAll() map[K]V

+ func (s *Sharded[K, V]) PeekMultiple(keys ...K) map[K]V

Jul 30, 2023

Changes in this version

type Cache

+ func (c *Cache[K, V]) CompareAndSwap(key K, expected, new V, compare func(V, V) bool, exp Expiration) (swapped, present bool)

+ func (c *Cache[K, V]) GetMultiple(keys ...K) map[K]V

type Sharded

+ func (s *Sharded[K, V]) CompareAndSwap(key K, expected, new V, compare func(V, V) bool, exp Expiration) (swapped, present bool)

+ func (s *Sharded[K, V]) GetMultiple(keys ...K) map[K]V

May 2, 2023

Changes in this version

type Cache

+ func (c *Cache[K, V]) ReplaceKey(old, new K, exp Expiration) bool

type EvictionReason

+ const EvictionReasonKeyReplaced

type Sharded

+ func (s *Sharded[K, V]) ReplaceKey(old, new K, exp Expiration) bool

Apr 30, 2023

Changes in this version

type Cache

+ func (c *Cache[K, V]) Close()

type Option

+ func WithCleanerOption(interval time.Duration) Option[K, V]

type Sharded

+ func (s *Sharded[K, V]) Close()

Apr 16, 2023

Changes in this version

type Cache

+ func (c *Cache[K, V]) RemoveExpired()

type EvictionReason

+ const EvictionReasonMaxEntriesExceeded

type Sharded

+ func (s *Sharded[K, V]) RemoveExpired()

Apr 14, 2023

Changes in this version

type EvictionReason

+ const EvictionReasonSizeExceeded

type Option

+ func WithMaxEntriesOption(n int) Option[K, V]

Apr 12, 2023

Changes in this version

+ type Imcache interface

+ Get func(key K) (v V, present bool)

+ GetAll func() map[K]V

+ GetOrSet func(key K, val V, exp Expiration) (v V, present bool)

+ Len func() int

+ Remove func(key K) (present bool)

+ RemoveAll func()

+ RemoveStale func()

+ Replace func(key K, val V, exp Expiration) (present bool)

+ ReplaceWithFunc func(key K, f func(old V) (new V), exp Expiration) (present bool)

+ Set func(key K, val V, exp Expiration)

+ StartCleaner func(interval time.Duration) error

+ StopCleaner func()

+ type Sharded struct

+ func (s *Sharded[K, V]) Get(key K) (V, bool)

+ func (s *Sharded[K, V]) GetAll() map[K]V

+ func (s *Sharded[K, V]) GetOrSet(key K, val V, exp Expiration) (v V, present bool)

+ func (s *Sharded[K, V]) Len() int

+ func (s *Sharded[K, V]) Remove(key K) bool

+ func (s *Sharded[K, V]) RemoveAll()

+ func (s *Sharded[K, V]) RemoveStale()

+ func (s *Sharded[K, V]) Replace(key K, val V, exp Expiration) bool

+ func (s *Sharded[K, V]) ReplaceWithFunc(key K, fn func(V) V, exp Expiration) bool

+ func (s *Sharded[K, V]) Set(key K, val V, exp Expiration)

+ func (s *Sharded[K, V]) StartCleaner(interval time.Duration) error

+ func (s *Sharded[K, V]) StopCleaner()

Apr 9, 2023

Changes in this version

+ func Decrement(old V) V

+ func Increment(old V) V

type Cache

+ ReplaceWithFunc func(key K, f func(old V) (new V), exp Expiration) (present bool)

+ type Number interface

Apr 9, 2023

Changes in this version

type Cache

+ GetOrSet func(key K, val V, exp Expiration) (v V, present bool)

+ StartCleaner func(interval time.Duration)

+ StopCleaner func()

type Expiration

+ func WithExpirationDate(t time.Time) Expiration

Apr 6, 2023

Changes in this version

type Cache

+ GetAll func() map[K]V

+ Len func() int

type EvictionReason

+ func (r EvictionReason) String() string

Apr 5, 2023

Changes in this version

+ type DefaultStringHasher64 struct

+ func (DefaultStringHasher64) Sum64(key string) uint64

+ type Hasher64 interface

+ Sum64 func(K) uint64

Apr 2, 2023

Changes in this version

+ var ErrAlreadyExists = errors.New("already exists")

+ var ErrNotFound = errors.New("not found")

+ var ErrTypeAssertion = errors.New("type assertion failure")

+ func Add(key string, val interface{}, exp Expiration) error

+ func Get(key string) (interface{}, error)

+ func GetConcrete(key string) (T, error)

+ func Remove(key string) error

+ func RemoveAll()

+ func RemoveStale()

+ func Replace(key string, val interface{}, exp Expiration) error

+ func Set(key string, val interface{}, exp Expiration)

+ func SetInstance(cache Cache)

+ type Cache interface

+ Add func(key string, val interface{}, exp Expiration) error

+ Get func(key string) (interface{}, error)

+ Remove func(key string) error

+ RemoveAll func()

+ RemoveStale func()

+ Replace func(key string, val interface{}, exp Expiration) error

+ Set func(key string, val interface{}, exp Expiration)

+ func New(opts ...Option) Cache

+ func NewSharded(n int, h32 Hasher32, opts ...Option) Cache

+ type EvictionCallback func(key string, val interface{}, reason EvictionReason)

+ type EvictionReason int32

+ const EvictionReasonExpired

+ const EvictionReasonRemoved

+ const EvictionReasonReplaced

+ type Expiration interface

+ func WithDefaultExpiration() Expiration

+ func WithExpiration(d time.Duration) Expiration

+ func WithNoExpiration() Expiration

+ func WithSlidingExpiration(d time.Duration) Expiration

+ type Hasher32 interface

+ Sum32 func(string) uint32

+ func NewDefaultHasher32() Hasher32

+ type Option interface

+ func WithDefaultExpirationOption(d time.Duration) Option

+ func WithDefaultSlidingExpirationOption(d time.Duration) Option

+ func WithEvictionCallbackOption(f EvictionCallback) Option