buffer

package

v0.1.0-alpha Latest Latest Go to latest Published: Aug 28, 2026 License: MIT Imports: 1 Imported by: 0

Details

Package buffer provides a concurrency-safe, byte-bounded circular buffer.

This section is empty.

This section is empty.

This section is empty.

type Buffer struct {
	// contains filtered or unexported fields
}

Buffer retains only the newest bytes written to it. It implements io.Writer and is safe for concurrent readers and writers.

func New(capacity int) *Buffer

New creates a Buffer with the requested byte capacity. Non-positive capacities are clamped to one byte.

func (b *Buffer) Bytes() []byte

Bytes returns the retained bytes in write order as an independent copy.

func (b *Buffer) Capacity() int

Capacity returns the maximum number of bytes retained by the buffer.

func (b *Buffer) Len() int

Len returns the number of bytes currently retained by the buffer.

func (b *Buffer) String() string

String returns the retained bytes in write order as a string.

func (b *Buffer) Write(p []byte) (int, error)

Write implements io.Writer. It reports the full input length even when old or leading bytes are discarded to respect the fixed capacity.