Source File
	writer.go

Belonging Package
	github.com/libp2p/go-buffer-pool

package pool

import (
	"bufio"
	"io"
	"sync"
)

const WriterBufferSize = 4096

var bufioWriterPool = sync.Pool{
	New: func() interface{} {
		return bufio.NewWriterSize(nil, WriterBufferSize)
	},
}

// Writer is a buffered writer that returns its internal buffer in a pool when
// not in use.
type Writer struct {
	W    io.Writer
	bufw *bufio.Writer
}

func (w *Writer) ensureBuffer() {
	if w.bufw == nil {
		w.bufw = bufioWriterPool.Get().(*bufio.Writer)
		w.bufw.Reset(w.W)
	}
}

// Write writes the given byte slice to the underlying connection.
//
// Note: Write won't return the write buffer to the pool even if it ends up
// being empty after the write. You must call Flush() to do that.
func (w *Writer) Write(b []byte) (int, error) {
	if w.bufw == nil {
		if len(b) >= WriterBufferSize {
			return w.W.Write(b)
		}
		w.bufw = bufioWriterPool.Get().(*bufio.Writer)
		w.bufw.Reset(w.W)
	}
	return w.bufw.Write(b)
}

// Size returns the size of the underlying buffer.
func (w *Writer) Size() int {
	return WriterBufferSize
}

// Available returns the amount buffer space available.
func (w *Writer) Available() int {
	if w.bufw != nil {
		return w.bufw.Available()
	}
	return WriterBufferSize
}

// Buffered returns the amount of data buffered.
func (w *Writer) Buffered() int {
	if w.bufw != nil {
		return w.bufw.Buffered()
	}
	return 0
}

// WriteByte writes a single byte.
func (w *Writer) WriteByte(b byte) error {
	w.ensureBuffer()
	return w.bufw.WriteByte(b)
}

// WriteRune writes a single rune, returning the number of bytes written.
func (w *Writer) WriteRune(r rune) (int, error) {
	w.ensureBuffer()
	return w.bufw.WriteRune(r)
}

// WriteString writes a string, returning the number of bytes written.
func (w *Writer) WriteString(s string) (int, error) {
	w.ensureBuffer()
	return w.bufw.WriteString(s)
}

// Flush flushes the write buffer, if any, and returns it to the pool.
func (w *Writer) Flush() error {
	if w.bufw == nil {
		return nil
	}
	if err := w.bufw.Flush(); err != nil {
		return err
	}
	w.bufw.Reset(nil)
	bufioWriterPool.Put(w.bufw)
	w.bufw = nil
	return nil
}

// Close flushes the underlying writer and closes it if it implements the
// io.Closer interface.
//
// Note: Close() closes the writer even if Flush() fails to avoid leaking system
// resources. If you want to make sure Flush() succeeds, call it first.
func (w *Writer) Close() error {
	var (
		ferr, cerr error
	)
	ferr = w.Flush()

	// always close even if flush fails.
	if closer, ok := w.W.(io.Closer); ok {
		cerr = closer.Close()
	}

	if ferr != nil {
		return ferr
	}
	return cerr
}

The pages are generated with Golds v0.8.2. (GOOS=linux GOARCH=amd64)
Golds is a Go 101 project developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @zigo_101 (reachable from the left QR code) to get the latest news of Golds.