89 lines
2.0 KiB
Go
89 lines
2.0 KiB
Go
package fasthttp
|
|
|
|
import (
|
|
"sync"
|
|
)
|
|
|
|
const (
|
|
defaultByteBufferSize = 128
|
|
)
|
|
|
|
// ByteBuffer provides byte buffer, which can be used with fasthttp API
|
|
// in order to minimize memory allocations.
|
|
//
|
|
// ByteBuffer may be used with functions appending data to the given []byte
|
|
// slice. See example code for details.
|
|
//
|
|
// Use AcquireByteBuffer for obtaining an empty byte buffer.
|
|
type ByteBuffer struct {
|
|
|
|
// B is a byte buffer to use in append-like workloads.
|
|
// See example code for details.
|
|
B []byte
|
|
}
|
|
|
|
// Write implements io.Writer - it appends p to ByteBuffer.B
|
|
func (b *ByteBuffer) Write(p []byte) (int, error) {
|
|
b.B = append(b.B, p...)
|
|
return len(p), nil
|
|
}
|
|
|
|
// WriteString appends s to ByteBuffer.B
|
|
func (b *ByteBuffer) WriteString(s string) (int, error) {
|
|
b.B = append(b.B, s...)
|
|
return len(s), nil
|
|
}
|
|
|
|
// Set sets ByteBuffer.B to p
|
|
func (b *ByteBuffer) Set(p []byte) {
|
|
b.B = append(b.B[:0], p...)
|
|
}
|
|
|
|
// SetString sets ByteBuffer.B to s
|
|
func (b *ByteBuffer) SetString(s string) {
|
|
b.B = append(b.B[:0], s...)
|
|
}
|
|
|
|
// Reset makes ByteBuffer.B empty.
|
|
func (b *ByteBuffer) Reset() {
|
|
b.B = b.B[:0]
|
|
}
|
|
|
|
// AcquireByteBuffer returns an empty byte buffer from the pool.
|
|
//
|
|
// Acquired byte buffer may be returned to the pool via ReleaseByteBuffer call.
|
|
// This reduces the number of memory allocations required for byte buffer
|
|
// management.
|
|
func AcquireByteBuffer() *ByteBuffer {
|
|
return defaultByteBufferPool.Acquire()
|
|
}
|
|
|
|
// ReleaseByteBuffer returns byte buffer to the pool.
|
|
//
|
|
// ByteBuffer.B mustn't be touched after returning it to the pool.
|
|
// Otherwise data races occur.
|
|
func ReleaseByteBuffer(b *ByteBuffer) {
|
|
defaultByteBufferPool.Release(b)
|
|
}
|
|
|
|
type byteBufferPool struct {
|
|
pool sync.Pool
|
|
}
|
|
|
|
var defaultByteBufferPool byteBufferPool
|
|
|
|
func (p *byteBufferPool) Acquire() *ByteBuffer {
|
|
v := p.pool.Get()
|
|
if v == nil {
|
|
return &ByteBuffer{
|
|
B: make([]byte, 0, defaultByteBufferSize),
|
|
}
|
|
}
|
|
return v.(*ByteBuffer)
|
|
}
|
|
|
|
func (p *byteBufferPool) Release(b *ByteBuffer) {
|
|
b.B = b.B[:0]
|
|
p.pool.Put(b)
|
|
}
|