func Init(cfg PoolConfig)
Init sets up a non-default pooling and allocation strategy. Should be run before serialization is done.
Buffer is a buffer optimized for serialization without extra copying.
type Buffer struct {
// Buf is the current chunk that can be used for serialization.
Buf []byte
// contains filtered or unexported fields
}
func (b *Buffer) AppendByte(data byte)
AppendByte appends a single byte to buffer.
func (b *Buffer) AppendBytes(data []byte)
AppendBytes appends a byte slice to buffer.
func (b *Buffer) AppendString(data string)
AppendString appends a string to buffer.
func (b *Buffer) BuildBytes(reuse ...[]byte) []byte
BuildBytes creates a single byte slice with all the contents of the buffer. Data is copied if it does not fit in a single chunk. You can optionally provide one byte slice as argument that it will try to reuse.
func (b *Buffer) DumpTo(w io.Writer) (written int, err error)
DumpTo outputs the contents of a buffer to a writer and resets the buffer.
func (b *Buffer) EnsureSpace(s int)
EnsureSpace makes sure that the current chunk contains at least s free bytes, possibly creating a new chunk.
func (b *Buffer) ReadCloser() io.ReadCloser
ReadCloser creates an io.ReadCloser with all the contents of the buffer.
func (b *Buffer) Size() int
Size computes the size of a buffer by adding sizes of every chunk.
PoolConfig contains configuration for the allocation and reuse strategy.
type PoolConfig struct {
StartSize int // Minimum chunk size that is allocated.
PooledSize int // Minimum chunk size that is reused, reusing chunks too small will result in overhead.
MaxSize int // Maximum chunk size that will be allocated.
}