freelru

Nov 20, 2024

Changes in this version

type Cache

+ GetAndRefresh func(key K, lifetime time.Duration) (V, bool)

type LRU

+ func (lru *LRU[K, V]) GetAndRefresh(key K, lifetime time.Duration) (V, bool)

type ShardedLRU

+ func (lru *ShardedLRU[K, V]) GetAndRefresh(key K, lifetime time.Duration) (value V, ok bool)

type SyncedLRU

+ func (lru *SyncedLRU[K, V]) GetAndRefresh(key K, lifetime time.Duration) (value V, ok bool)

Oct 15, 2024

Changes in this version

type Cache

+ PurgeExpired func()

+ RemoveOldest func() (key K, value V, removed bool)

type LRU

+ func (lru *LRU[K, V]) PurgeExpired()

+ func (lru *LRU[K, V]) RemoveOldest() (key K, value V, removed bool)

type ShardedLRU

+ func (lru *ShardedLRU[K, V]) PurgeExpired()

+ func (lru *ShardedLRU[K, V]) RemoveOldest() (key K, value V, removed bool)

type SyncedLRU

+ func (lru *SyncedLRU[K, V]) PurgeExpired()

+ func (lru *SyncedLRU[K, V]) RemoveOldest() (key K, value V, removed bool)

Feb 20, 2024

Changes in this version

type Cache

+ Metrics func() Metrics

+ ResetMetrics func() Metrics

type LRU

+ func (lru *LRU[K, V]) Metrics() Metrics

+ func (lru *LRU[K, V]) ResetMetrics() Metrics

+ type Metrics struct

+ Collisions uint64

+ Evictions uint64

+ Hits uint64

+ Inserts uint64

+ Misses uint64

+ Removals uint64

type ShardedLRU

+ func (lru *ShardedLRU[K, V]) Metrics() Metrics

+ func (lru *ShardedLRU[K, V]) ResetMetrics() Metrics

type SyncedLRU

+ func (lru *SyncedLRU[K, V]) Metrics() Metrics

+ func (lru *SyncedLRU[K, V]) ResetMetrics() Metrics

Jan 10, 2024

Changes in this version

+ type Cache interface

+ Add func(key K, value V) (evicted bool)

+ AddWithLifetime func(key K, value V, lifetime time.Duration) (evicted bool)

+ Contains func(key K) bool

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

+ Keys func() []K

+ Len func() int

+ Peek func(key K) (V, bool)

+ Purge func()

+ Remove func(key K) bool

+ SetLifetime func(lifetime time.Duration)

+ SetOnEvict func(onEvict OnEvictCallback[K, V])

Jan 2, 2024

Changes in this version

+ type ShardedLRU struct

+ func NewShardedWithSize[K comparable, V any](shards, cap, size uint32, hash HashKeyCallback[K]) (*ShardedLRU[K, V], error)

+ func NewSharded[K comparable, V any](cap uint32, hash HashKeyCallback[K]) (*ShardedLRU[K, V], error)

+ func (lru *ShardedLRU[K, V]) Add(key K, value V) (evicted bool)

+ func (lru *ShardedLRU[K, V]) AddWithLifetime(key K, value V, lifetime time.Duration) (evicted bool)

+ func (lru *ShardedLRU[K, V]) Contains(key K) (ok bool)

+ func (lru *ShardedLRU[K, V]) Get(key K) (value V, ok bool)

+ func (lru *ShardedLRU[K, V]) Keys() []K

+ func (lru *ShardedLRU[K, V]) Len() (length int)

+ func (lru *ShardedLRU[K, V]) Peek(key K) (value V, ok bool)

+ func (lru *ShardedLRU[K, V]) PrintStats()

+ func (lru *ShardedLRU[K, V]) Purge()

+ func (lru *ShardedLRU[K, V]) Remove(key K) (removed bool)

+ func (lru *ShardedLRU[K, V]) SetLifetime(lifetime time.Duration)

+ func (lru *ShardedLRU[K, V]) SetOnEvict(onEvict OnEvictCallback[K, V])

Dec 19, 2023

Changes in this version

+ type SyncedLRU struct

+ func NewSyncedWithSize[K comparable, V any](cap, size uint32, hash HashKeyCallback[K]) (*SyncedLRU[K, V], error)

+ func NewSynced[K comparable, V any](cap uint32, hash HashKeyCallback[K]) (*SyncedLRU[K, V], error)

+ func (lru *SyncedLRU[K, V]) Add(key K, value V) (evicted bool)

+ func (lru *SyncedLRU[K, V]) AddWithLifetime(key K, value V, lifetime time.Duration) (evicted bool)

+ func (lru *SyncedLRU[K, V]) Contains(key K) (ok bool)

+ func (lru *SyncedLRU[K, V]) Get(key K) (value V, ok bool)

+ func (lru *SyncedLRU[K, V]) Keys() []K

+ func (lru *SyncedLRU[K, V]) Len() int

+ func (lru *SyncedLRU[K, V]) Peek(key K) (value V, ok bool)

+ func (lru *SyncedLRU[K, V]) PrintStats()

+ func (lru *SyncedLRU[K, V]) Purge()

+ func (lru *SyncedLRU[K, V]) Remove(key K) (removed bool)

+ func (lru *SyncedLRU[K, V]) SetLifetime(lifetime time.Duration)

+ func (lru *SyncedLRU[K, V]) SetOnEvict(onEvict OnEvictCallback[K, V])

Dec 18, 2023

Changes in this version

type LRU

+ func (lru *LRU[K, V]) AddWithLifetime(key K, value V, lifetime time.Duration) (evicted bool)

Mar 27, 2023

Changes in this version

type LRU

+ func (lru *LRU[K, V]) Purge()

Mar 25, 2023

Changes in this version

type LRU

+ func NewWithSize(cap, size uint32, hash HashKeyCallback[K]) (*LRU[K, V], error)

+ func (lru *LRU[K, V]) SetLifetime(lifetime time.Duration)

+ func (lru *LRU[K, V]) SetOnEvict(onEvict OnEvictCallback[K, V])

Mar 3, 2023

Changes in this version

type Config

+ Lifetime time.Duration

type LRU

+ func (lru *LRU[K, V]) AddWithExpire(key K, value V, lifetime time.Duration) (evicted bool)

Jan 25, 2023

Changes in this version

+ type Config struct

+ Capacity uint32

+ HashKey HashKeyCallback[K]

+ OnEvict OnEvictCallback[K, V]

+ Size uint32

+ func DefaultConfig() Config[K, V]

+ type HashKeyCallback func(K) uint32

+ type LRU struct

+ func New(cap uint32, onEvict OnEvictCallback[K, V], hash HashKeyCallback[K]) (*LRU[K, V], error)

+ func NewWithConfig(cfg Config[K, V]) (*LRU[K, V], error)

+ func (lru *LRU[K, V]) Add(key K, value V) (evicted bool)

+ func (lru *LRU[K, V]) Contains(key K) (ok bool)

+ func (lru *LRU[K, V]) Get(key K) (value V, ok bool)

+ func (lru *LRU[K, V]) Keys() []K

+ func (lru *LRU[K, V]) Len() int

+ func (lru *LRU[K, V]) Peek(key K) (value V, ok bool)

+ func (lru *LRU[K, V]) PrintStats()

+ func (lru *LRU[K, V]) Remove(key K) (removed bool)

+ type OnEvictCallback func(K, V)