src/pkg/net/textproto/writer.go - The Go Programming Language

Golang

Source file src/pkg/net/textproto/writer.go

     1	// Copyright 2010 The Go Authors.  All rights reserved.
     2	// Use of this source code is governed by a BSD-style
     3	// license that can be found in the LICENSE file.
     4	
     5	package textproto
     6	
     7	import (
     8		"bufio"
     9		"fmt"
    10		"io"
    11	)
    12	
    13	// A Writer implements convenience methods for writing
    14	// requests or responses to a text protocol network connection.
    15	type Writer struct {
    16		W   *bufio.Writer
    17		dot *dotWriter
    18	}
    19	
    20	// NewWriter returns a new Writer writing to w.
    21	func NewWriter(w *bufio.Writer) *Writer {
    22		return &Writer{W: w}
    23	}
    24	
    25	var crnl = []byte{'\r', '\n'}
    26	var dotcrnl = []byte{'.', '\r', '\n'}
    27	
    28	// PrintfLine writes the formatted output followed by \r\n.
    29	func (w *Writer) PrintfLine(format string, args ...interface{}) error {
    30		w.closeDot()
    31		fmt.Fprintf(w.W, format, args...)
    32		w.W.Write(crnl)
    33		return w.W.Flush()
    34	}
    35	
    36	// DotWriter returns a writer that can be used to write a dot-encoding to w.
    37	// It takes care of inserting leading dots when necessary,
    38	// translating line-ending \n into \r\n, and adding the final .\r\n line
    39	// when the DotWriter is closed.  The caller should close the
    40	// DotWriter before the next call to a method on w.
    41	//
    42	// See the documentation for Reader's DotReader method for details about dot-encoding.
    43	func (w *Writer) DotWriter() io.WriteCloser {
    44		w.closeDot()
    45		w.dot = &dotWriter{w: w}
    46		return w.dot
    47	}
    48	
    49	func (w *Writer) closeDot() {
    50		if w.dot != nil {
    51			w.dot.Close() // sets w.dot = nil
    52		}
    53	}
    54	
    55	type dotWriter struct {
    56		w     *Writer
    57		state int
    58	}
    59	
    60	const (
    61		wstateBeginLine = iota // beginning of line; initial state; must be zero
    62		wstateCR               // wrote \r (possibly at end of line)
    63		wstateData             // writing data in middle of line
    64	)
    65	
    66	func (d *dotWriter) Write(b []byte) (n int, err error) {
    67		bw := d.w.W
    68		for n < len(b) {
    69			c := b[n]
    70			switch d.state {
    71			case wstateBeginLine:
    72				d.state = wstateData
    73				if c == '.' {
    74					// escape leading dot
    75					bw.WriteByte('.')
    76				}
    77				fallthrough
    78	
    79			case wstateData:
    80				if c == '\r' {
    81					d.state = wstateCR
    82				}
    83				if c == '\n' {
    84					bw.WriteByte('\r')
    85					d.state = wstateBeginLine
    86				}
    87	
    88			case wstateCR:
    89				d.state = wstateData
    90				if c == '\n' {
    91					d.state = wstateBeginLine
    92				}
    93			}
    94			if err = bw.WriteByte(c); err != nil {
    95				break
    96			}
    97			n++
    98		}
    99		return
   100	}
   101	
   102	func (d *dotWriter) Close() error {
   103		if d.w.dot == d {
   104			d.w.dot = nil
   105		}
   106		bw := d.w.W
   107		switch d.state {
   108		default:
   109			bw.WriteByte('\r')
   110			fallthrough
   111		case wstateCR:
   112			bw.WriteByte('\n')
   113			fallthrough
   114		case wstateBeginLine:
   115			bw.Write(dotcrnl)
   116		}
   117		return bw.Flush()
   118	}