123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236 |
- package fwd
- import "io"
- const (
- // DefaultWriterSize is the
- // default write buffer size.
- DefaultWriterSize = 2048
- minWriterSize = minReaderSize
- )
- // Writer is a buffered writer
- type Writer struct {
- w io.Writer // writer
- buf []byte // 0:len(buf) is bufered data
- }
- // NewWriter returns a new writer
- // that writes to 'w' and has a buffer
- // that is `DefaultWriterSize` bytes.
- func NewWriter(w io.Writer) *Writer {
- if wr, ok := w.(*Writer); ok {
- return wr
- }
- return &Writer{
- w: w,
- buf: make([]byte, 0, DefaultWriterSize),
- }
- }
- // NewWriterSize returns a new writer that
- // writes to 'w' and has a buffer size 'n'.
- func NewWriterSize(w io.Writer, n int) *Writer {
- if wr, ok := w.(*Writer); ok && cap(wr.buf) >= n {
- return wr
- }
- buf := make([]byte, 0, max(n, minWriterSize))
- return NewWriterBuf(w, buf)
- }
- // NewWriterBuf returns a new writer
- // that writes to 'w' and has 'buf' as a buffer.
- // 'buf' is not used when has smaller capacity than 18,
- // custom buffer is allocated instead.
- func NewWriterBuf(w io.Writer, buf []byte) *Writer {
- if cap(buf) < minWriterSize {
- buf = make([]byte, 0, minWriterSize)
- }
- buf = buf[:0]
- return &Writer{
- w: w,
- buf: buf,
- }
- }
- // Buffered returns the number of buffered bytes
- // in the reader.
- func (w *Writer) Buffered() int { return len(w.buf) }
- // BufferSize returns the maximum size of the buffer.
- func (w *Writer) BufferSize() int { return cap(w.buf) }
- // Flush flushes any buffered bytes
- // to the underlying writer.
- func (w *Writer) Flush() error {
- l := len(w.buf)
- if l > 0 {
- n, err := w.w.Write(w.buf)
- // if we didn't write the whole
- // thing, copy the unwritten
- // bytes to the beginnning of the
- // buffer.
- if n < l && n > 0 {
- w.pushback(n)
- if err == nil {
- err = io.ErrShortWrite
- }
- }
- if err != nil {
- return err
- }
- w.buf = w.buf[:0]
- return nil
- }
- return nil
- }
- // Write implements `io.Writer`
- func (w *Writer) Write(p []byte) (int, error) {
- c, l, ln := cap(w.buf), len(w.buf), len(p)
- avail := c - l
- // requires flush
- if avail < ln {
- if err := w.Flush(); err != nil {
- return 0, err
- }
- l = len(w.buf)
- }
- // too big to fit in buffer;
- // write directly to w.w
- if c < ln {
- return w.w.Write(p)
- }
- // grow buf slice; copy; return
- w.buf = w.buf[:l+ln]
- return copy(w.buf[l:], p), nil
- }
- // WriteString is analogous to Write, but it takes a string.
- func (w *Writer) WriteString(s string) (int, error) {
- c, l, ln := cap(w.buf), len(w.buf), len(s)
- avail := c - l
- // requires flush
- if avail < ln {
- if err := w.Flush(); err != nil {
- return 0, err
- }
- l = len(w.buf)
- }
- // too big to fit in buffer;
- // write directly to w.w
- //
- // yes, this is unsafe. *but*
- // io.Writer is not allowed
- // to mutate its input or
- // maintain a reference to it,
- // per the spec in package io.
- //
- // plus, if the string is really
- // too big to fit in the buffer, then
- // creating a copy to write it is
- // expensive (and, strictly speaking,
- // unnecessary)
- if c < ln {
- return w.w.Write(unsafestr(s))
- }
- // grow buf slice; copy; return
- w.buf = w.buf[:l+ln]
- return copy(w.buf[l:], s), nil
- }
- // WriteByte implements `io.ByteWriter`
- func (w *Writer) WriteByte(b byte) error {
- if len(w.buf) == cap(w.buf) {
- if err := w.Flush(); err != nil {
- return err
- }
- }
- w.buf = append(w.buf, b)
- return nil
- }
- // Next returns the next 'n' free bytes
- // in the write buffer, flushing the writer
- // as necessary. Next will return `io.ErrShortBuffer`
- // if 'n' is greater than the size of the write buffer.
- // Calls to 'next' increment the write position by
- // the size of the returned buffer.
- func (w *Writer) Next(n int) ([]byte, error) {
- c, l := cap(w.buf), len(w.buf)
- if n > c {
- return nil, io.ErrShortBuffer
- }
- avail := c - l
- if avail < n {
- if err := w.Flush(); err != nil {
- return nil, err
- }
- l = len(w.buf)
- }
- w.buf = w.buf[:l+n]
- return w.buf[l:], nil
- }
- // take the bytes from w.buf[n:len(w.buf)]
- // and put them at the beginning of w.buf,
- // and resize to the length of the copied segment.
- func (w *Writer) pushback(n int) {
- w.buf = w.buf[:copy(w.buf, w.buf[n:])]
- }
- // ReadFrom implements `io.ReaderFrom`
- func (w *Writer) ReadFrom(r io.Reader) (int64, error) {
- // anticipatory flush
- if err := w.Flush(); err != nil {
- return 0, err
- }
- w.buf = w.buf[0:cap(w.buf)] // expand buffer
- var nn int64 // written
- var err error // error
- var x int // read
- // 1:1 reads and writes
- for err == nil {
- x, err = r.Read(w.buf)
- if x > 0 {
- n, werr := w.w.Write(w.buf[:x])
- nn += int64(n)
- if err != nil {
- if n < x && n > 0 {
- w.pushback(n - x)
- }
- return nn, werr
- }
- if n < x {
- w.pushback(n - x)
- return nn, io.ErrShortWrite
- }
- } else if err == nil {
- err = io.ErrNoProgress
- break
- }
- }
- if err != io.EOF {
- return nn, err
- }
- // we only clear here
- // because we are sure
- // the writes have
- // succeeded. otherwise,
- // we retain the data in case
- // future writes succeed.
- w.buf = w.buf[0:0]
- return nn, nil
- }
|