memory

Jul 29, 2025

Changes in this version

+ const StringBuilderSize

type PoolMetrics

+ Hits int64

+ Misses int64

Jul 29, 2025

Changes in this version

+ const DefaultBufferSize

+ const HashBufferSize

+ const LargeBufferSize

+ const LargeStringBuilderSize

+ const MaxRetainedBufferSize

+ const MediumBufferSize

+ const MediumStringBuilderSize

+ const SmallBufferSize

+ const SmallStringBuilderSize

+ const TarBufferSize

+ func DisableMemoryTracking()

+ func EnableMemoryTracking()

+ func GetBuffer(size BufferSize) []byte

+ func GetStringBuilder(size PoolSize) *strings.Builder

+ func IsMemoryTrackingEnabled() bool

+ func PutBuffer(buffer []byte, size BufferSize)

+ func PutStringBuilder(builder *strings.Builder, size PoolSize)

+ func ResetBufferPoolMetrics()

+ func ResetMemoryMetrics()

+ func ResetPoolMetrics()

+ func TrackAllocation(bytes int64)

+ func TrackBufferReuse()

+ func TrackOperation(duration time.Duration)

+ func TrackPoolHitRate(hitRate float64)

+ func TrackStringReuse()

+ func WithBuffer(size BufferSize, fn func([]byte))

+ func WithBufferReturn[T any](size BufferSize, fn func([]byte) T) T

+ func WithStringBuilder(size PoolSize, fn func(*strings.Builder) string) string

+ type BufferPool struct

+ func NewBufferPool() *BufferPool

+ func (p *BufferPool) Get(size BufferSize) []byte

+ func (p *BufferPool) GetMetrics() BufferPoolMetrics

+ func (p *BufferPool) Put(buffer []byte, size BufferSize)

+ type BufferPoolMetrics struct

+ HashHits int64

+ HashMisses int64

+ LargeHits int64

+ LargeMisses int64

+ MediumHits int64

+ MediumMisses int64

+ SmallHits int64

+ SmallMisses int64

+ TarHits int64

+ TarMisses int64

+ func GetBufferPoolMetrics() BufferPoolMetrics

+ func (m BufferPoolMetrics) HitRate() float64

+ type BufferSize int

+ const HashBuffer

+ const LargeBuffer

+ const MediumBuffer

+ const SmallBuffer

+ const TarBuffer

+ func EstimateBufferSize(estimatedDataSize int) BufferSize

+ type MemoryMetrics struct

+ BufferReuseCount int64

+ LastGCTimestamp time.Time

+ OperationCount int64

+ PeakAllocBytes int64

+ PoolHitRate float64

+ StringReuseCount int64

+ TotalAllocBytes int64

+ TotalAllocations int64

+ TotalDuration time.Duration

+ func GetMemoryMetrics() MemoryMetrics

+ func WithMemoryTracking(fn func()) MemoryMetrics

+ func (m MemoryMetrics) AverageAllocationSize() int64

+ func (m MemoryMetrics) AverageOperationDuration() time.Duration

+ func (m MemoryMetrics) ReuseEfficiency() float64

+ type MemoryTracker struct

+ func NewMemoryTracker() *MemoryTracker

+ func (mt *MemoryTracker) Disable()

+ func (mt *MemoryTracker) Enable()

+ func (mt *MemoryTracker) GetMetrics() MemoryMetrics

+ func (mt *MemoryTracker) IsEnabled() bool

+ func (mt *MemoryTracker) Reset()

+ func (mt *MemoryTracker) TrackAllocation(bytes int64)

+ func (mt *MemoryTracker) TrackBufferReuse()

+ func (mt *MemoryTracker) TrackOperation(duration time.Duration)

+ func (mt *MemoryTracker) TrackPoolHitRate(hitRate float64)

+ func (mt *MemoryTracker) TrackStringReuse()

+ func (mt *MemoryTracker) UpdateGCTimestamp()

+ type PoolMetrics struct

+ LargeHits int64

+ LargeMisses int64

+ MediumHits int64

+ MediumMisses int64

+ SmallHits int64

+ SmallMisses int64

+ func GetPoolMetrics() PoolMetrics

+ func (m PoolMetrics) HitRate() float64

+ type PoolSize int

+ const Large

+ const Medium

+ const Small

+ func EstimateSize(estimatedLength int) PoolSize

+ type StringBuilderPool struct

+ func NewStringBuilderPool() *StringBuilderPool

+ func (p *StringBuilderPool) Get(size PoolSize) *strings.Builder

+ func (p *StringBuilderPool) GetMetrics() PoolMetrics

+ func (p *StringBuilderPool) Put(builder *strings.Builder, size PoolSize)

+ type SystemMemoryStats struct

+ Alloc uint64

+ Frees uint64

+ GCCPUFraction float64

+ HeapAlloc uint64

+ HeapIdle uint64

+ HeapInuse uint64

+ HeapReleased uint64

+ HeapSys uint64

+ LastGC time.Time

+ Lookups uint64

+ Mallocs uint64

+ NumGC uint32

+ Sys uint64

+ TotalAlloc uint64

+ func GetSystemMemoryStats() SystemMemoryStats