pool

package

v0.9.0 Latest Latest Go to latest Published: Nov 24, 2025 License: Apache-2.0 Imports: 4 Imported by: 0

Details

Package pool provides a pool for reusing objects.

This section is empty.

This section is empty.

func AllRefsCount() map[string]int

AllRefsCount returns the reference count of all pools.

func AllStacks() map[string][]string

AllStacks returns all recorded stack traces for leaked objects from all pools.

func EnableStackTracking(enabled bool)

EnableStackTracking enables or disables stack tracking for all pools.

type StackTracker interface {
	// Stacks returns all recorded stack traces for objects in the pool.
	Stacks() []string
}

StackTracker is the interface that wraps the Stacks method.

type Synced[T any] struct {
	sync.Pool
	// contains filtered or unexported fields
}

Synced is a pool that is safe for concurrent use.

func Register[T any](name string) *Synced[T]

Register registers a new pool with the given name.

func (p *Synced[T]) Get() T

Get returns an object from the pool. If the pool is empty, nil is returned.

func (p *Synced[T]) Put(v T)

Put puts an object back to the pool.

func (p *Synced[T]) RefsCount() int

RefsCount returns the reference count of the pool.

func (p *Synced[T]) Stacks() []string

Stacks returns all recorded stack traces for objects in this pool.

type Trackable interface {
	// RefsCount returns the reference count of the pool.
	RefsCount() int
}

Trackable is the interface that wraps the RefsCount method.